收货地址解析
最后更新于：2022-04-02 08:18:27
## 收货地址解析
>[danger]### 会员接口，仅限会员使用，购买[API会员](https://market.topthink.com/product/210)
> 此接口可以解析出文本中的收货人姓名、联系方式、邮编和详细地址。并且可以将地址拆分出省市区（自治区、旗、盟等），方便电商和物流等项目应用。text参数中的内容同一类型（例如电话号码和邮编都是数字，连在一起的话，最好有空格或逗号相隔）。
## 接口调用（[调用须知](https://docs.topthink.com/think-api/1835086)）
### 请求地址
```
GET https://api.topthink.com/express/address
```
### 请求参数
| 名称 | 必填 | 类型 | 说明 |
| --- | --- | --- | --- |
| appCode| 是 |string| 用户授权码，参考[API调用](https://docs.topthink.com/think-api/1835086) |
| text| 是 | string | 文本内容 |
### 返回`data`参数
| 名称 | 类型 | 示例值 | 说明 |
| --- | --- | --- | --- |
| mobile | string | 13800138000 | 移动电话号码 |
| name | string | 马云 | 收货人姓名 |
| province | string | 浙江省 | 省/特区/自治区/直辖市 |
| city | string | 杭州市 | 城市 |
| district | string | 滨江区 | 区县 |
| postcode | string | 310052 | 邮编 |
| detail | string | 浙江省杭州市滨江区网商路699号 | 完整收货地址 |
## SDK调用
```
$client = new Client("YourAppCode");
$result = $client->expressAddress()
->withText('马云,13800138000浙江省杭州市滨江区网商路699号310052')
->request();
```
返回示例：
~~~
{
"code":0,
"message": "成功的返回",
"data": {
"mobile":"13800138000",
"name":"马云",
"province":"浙江省",
"city":"杭州市",
"district":"滨江区",
"postcode":"310052",
"detail":"浙江省杭州市滨江区网商路699号"
}
}
~~~
';