首頁 > 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"
}