POST已開放shipping-address-parse

快递地址解析

从一段杂乱文本中智能识别中国快递收件信息：姓名、手机号、身份证、邮编、省/市/区、详细地址。支持单条与批量（≤200 条/次），批量可按手机号 / 姓名去重。

接入文件

暫無詳細簡介，您可以先參考下方的接入示例。

接入示例程式碼

提供 Shell、Python、Go、Java、PHP 等常見接入示例，便於直接接到現有專案裡。

Shell 示例Python 示例Go 示例Java 示例PHP 示例

Shell 示例

curl --request POST \
  --url 'https://openapi.toolkk.com/v1/shipping-address-parse' \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: YOUR_API_KEY' \
  --data '{\n  "addresses": [\n    "张三 13800138000 广东省深圳市南山区科技园路 1 号 518000",\n    "李四 13900139000 北京市朝阳区建国路 88 号"\n  ],\n  "dedup": "phone"\n}'

Python 示例

import os
import requests

url = "https://openapi.toolkk.com/v1/shipping-address-parse"
payload = {
  "addresses": [
    "张三 13800138000 广东省深圳市南山区科技园路 1 号 518000",
    "李四 13900139000 北京市朝阳区建国路 88 号"
  ],
  "dedup": "phone"
}

headers = {
    "Content-Type": "application/json",
    "X-API-Key": os.getenv("TOOLKK_API_KEY", "YOUR_API_KEY"),
}

response = requests.request("POST", url, headers=headers, json=payload, timeout=30)
response.raise_for_status()
print(response.json())

Go 示例

package main

import (
    "bytes"
    "fmt"
    "io"
    "net/http"
)

func main() {
    endpoint := "https://openapi.toolkk.com/v1/shipping-address-parse"
    payload := []byte("{\n  \"addresses\": [\n    \"张三 13800138000 广东省深圳市南山区科技园路 1 号 518000\",\n    \"李四 13900139000 北京市朝阳区建国路 88 号\"\n  ],\n  \"dedup\": \"phone\"\n}")

    req, err := http.NewRequest("POST", endpoint, bytes.NewBuffer(payload))
    if err != nil {
        panic(err)
    }

    req.Header.Set("Content-Type", "application/json")
    req.Header.Set("X-API-Key", "YOUR_API_KEY")

    resp, err := http.DefaultClient.Do(req)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()

    body, err := io.ReadAll(resp.Body)
    if err != nil {
        panic(err)
    }

    fmt.Println(string(body))
}

Java 示例

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

public class ToolkkExample {
    public static void main(String[] args) throws Exception {
        String payload = "{\n  \"addresses\": [\n    \"张三 13800138000 广东省深圳市南山区科技园路 1 号 518000\",\n    \"李四 13900139000 北京市朝阳区建国路 88 号\"\n  ],\n  \"dedup\": \"phone\"\n}";

        HttpRequest request = HttpRequest.newBuilder()
            .uri(URI.create("https://openapi.toolkk.com/v1/shipping-address-parse"))
            .method("POST", HttpRequest.BodyPublishers.ofString(payload))
            .header("Content-Type", "application/json")
            .header("X-API-Key", "YOUR_API_KEY")
            .build();

        HttpResponse<String> response = HttpClient.newHttpClient()
            .send(request, HttpResponse.BodyHandlers.ofString());

        System.out.println(response.body());
    }
}

PHP 示例

<?php

$endpoint = 'https://openapi.toolkk.com/v1/shipping-address-parse';
$payload = "{\n  \"addresses\": [\n    \"张三 13800138000 广东省深圳市南山区科技园路 1 号 518000\",\n    \"李四 13900139000 北京市朝阳区建国路 88 号\"\n  ],\n  \"dedup\": \"phone\"\n}";

$ch = curl_init($endpoint);
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_CUSTOMREQUEST => 'POST',
    CURLOPT_HTTPHEADER => [
        'Content-Type: application/json',
        'X-API-Key: YOUR_API_KEY',
    ],
    CURLOPT_POSTFIELDS => $payload,
]);

$response = curl_exec($ch);
if ($response === false) {
    throw new RuntimeException(curl_error($ch));
}

curl_close($ch);
echo $response;

請求示例

{
  "addresses": [
    "张三 13800138000 广东省深圳市南山区科技园路 1 号 518000",
    "李四 13900139000 北京市朝阳区建国路 88 号"
  ],
  "dedup": "phone"
}

響應示例

{
  "code": "SUCCESS",
  "message": "success",
  "data": {
    "count": 2,
    "originalCount": 2,
    "removed": 0,
    "items": [
      {
        "name": "张三",
        "mobile": "13800138000",
        "idn": null,
        "postcode": "518000",
        "province": "广东省",
        "city": "深圳市",
        "region": "南山区",
        "street": "科技园路1号",
        "original": "张三 13800138000 广东省深圳市南山区科技园路 1 号 518000"
      },
      {
        "name": "李四",
        "mobile": "13900139000",
        "idn": null,
        "postcode": null,
        "province": "北京市",
        "city": "北京市",
        "region": "朝阳区",
        "street": "建国路88号",
        "original": "李四 13900139000 北京市朝阳区建国路 88 号"
      }
    ]
  }
}

請求欄位

以下欄位根據示例 JSON 自動提取，僅作接入參考。

欄位路徑	型別	示例值
addresses	array	"张三 13800138000 广东省深圳市南山区科技园路 1 号 518000"
addresses[]	string	张三 13800138000 广东省深圳市南山区科技园路 1 号 518000
dedup	string	phone

響應欄位