首页 > API文档 > 智能地址解析API
智能地址解析API为用户提供地址解析与补全服务,用户提供收寄件地址电话姓名,即可自动解析出省、市、区、街道、详细地址、姓名、联系电话,为用户解决地址填写问题。
(1)电商平台、寄件平台、ERP后台,下单前或下单后无序的收件地址与收件人信息,可通过智能地址解析API,智能化的解析出省、市、区、街道、详细地址、姓名、联系电话。
(2)电商平台、寄件平台、ERP后台,下单前或下单后不完整的收件地址,可通过此智能地址解析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 | 详细地址 | 否 |
三、示例
{
“Content”: “深圳市龙岗区坂田街道长坑路西2巷2号202 黄大大 18273778575”
}
{
"EBusinessID" : "1279441",
"Data" : {
"ProvinceName" : "广东省",
"StreetName" : "坂田街道",
"Address" : "长坑路西2巷2号202",
"CityName" : "深圳市",
"ExpAreaName" : "龙岗区",
"Mobile" : "18273778575",
"Name" : "黄大大"
},
"Success" : true,
"Reason" : "解析成功",
"ResultCode" : "100"
}