快递智能地址解析API接口代码
官网:快递鸟
API参数
一、接口描述/说明
1.接口说明
(1)智能解析接口支持按照按文本内容解析(单个解析)。
(2)文本内容越详细,解析越准确,不同的字段内容可用空格区分。
(3)接口指令6001。
(4)接口支持的消息接收方式为HTTP POST,请求方法的编码格式(utf-8):"application/x-www-form-urlencoded;charset=utf-8"。
(5)接口地址:API正式地https://api.kdniao.com/api/dist
请求系统级参数说明:
参数名称 | 类型 | 说明 | 必须要求 |
---|---|---|---|
RequestData | String | 请求内容需进行URL(utf-8)编码。请求内容JSON格式,须和DataType一致。 | 是 |
EBusinessID | String | 商户ID,请在我的服务页面查看。 | 是 |
RequestType | String | 请求指令类型:6001 | 是 |
DataSign | String | 数据内容签名:把(请求内容(未编码)+AppKey)进行MD5加密,然后Base64编码,最后 进行URL(utf-8)编码。详细过程请查看Demo。 | 是 |
DataType | String | DataType=2,请求、返回数据类型:只支持JSON格式 | 是 |
二、接口参数
请求内容字段定义:
参数名称 | 类型 | 说明 | 是否必须 | |
---|---|---|---|---|
Content | String | 需要识别的地址与收件人信息,为提高准确率不同信息可用空格区分。 | 是 |
返回参数定义:
参数名称 | 类型 | 说明 | 必须要求 | |
---|---|---|---|---|
EBusinessID | String | 电商用户ID | 是 | |
Success | Bool | 成功与否 | 是 | |
ResultCode | String | 返回编码 | 是 | |
Reason | String | 失败原因 | 否 | |
Data | Name | String | 姓名 | 否 |
Mobile | String | 手机或座机 | 否 | |
ProvinceName | String | 省 | 否 | |
CityName | String | 市 | 否 | |
ExpAreaName | String | 区/县 | 否 | |
StreetName | String | 街道名称 | 否 | |
Address | String | 详细地址 | 否 |
三、示例
请求示例 JSON
{
“Content”: “深圳市龙岗区坂田街道长坑路西2巷2号202 黄大大 18273778575”
}
返回示例 JSON
{
"EBusinessID" : "1279441",
"Data" : {
"ProvinceName" : "广东省",
"StreetName" : "坂田街道",
"Address" : "长坑路西2巷2号202",
"CityName" : "深圳市",
"ExpAreaName" : "龙岗区",
"Mobile" : "18273778575",
"Name" : "黄大大"
},
"Success" : true,
"Reason" : "解析成功",
"ResultCode" : "100"
}