批量錄入快遞地址-快寶地址服務（PHP代碼示例）

快遞地址寫錯了怎麼辦？快遞地址寫的不詳細怎麼辦？怎麼皮批量錄入收件人地址？微商怎麼批量錄入發件人地址？快寶地址清洗，有效的解決了寄送快遞時，批量錄入收件人信息、發件人信息時，糾正地址數據，不完整地址識別，地址信息不完整時補全，已經合併區縣的地址更正為最新的區縣等，並輸出結構化地址數據的一個有效方案。

一、地址清洗適用場景

1. 不完整地址識別
比如地址“山東省煙臺市煙臺市峰哥”，由省市街道組成，調用快寶地址清洗API，將會給你返回如下地址數據

省：山東省  
市：煙臺市  
區/縣：  
地址：煙臺市峰哥 

2. 地址補全
比如地址“新疆－和田－和田”，由不完整的省市區組成，將會被識別成為如下地址結構：

省：新疆維吾爾自治區  
市：和田地區  
區/縣：和田市  
地址： 

3. 識別已合併的區/縣
比如地址“北京市宣武區茶兒衚衕”，其中有被合併為西城區的宣武區，將會被識別為如下的地址結構：

省：北京市  
市：北京市  
區/縣：西城區  
地址：茶兒衚衕  

二、介面說明

1. 註冊快寶開放平臺，獲取開發者賬號（http://open.kuaidihelp.com/register）。

2. 對接地址清洗介面（http://open.kuaidihelp.com/api/1019）。

3. 在您的軟體中應用地址清洗。

介面名稱：cloud.address.cleanse

正式地址：https://kop.kuaidihelp.com/api

請求方式：HTTP POST

請求方法編碼格式：utf-8

公共請求參數 ↓ 

公共響應參數 ↓ 

請求參數 ↓ 

響應參數  ↓ 

支持Java，C#，Python，PHP，Node.js，Curl等6中語言接入，下麵以PHP為例，展示地址清洗代碼示例：

 1 $host = "https://kop.kuaidihelp.com/api";  
 2 $method = "POST";  
 3 $headers = array();  
 4 //根據API的要求，定義相對應的Content-Type  
 5 array_push($headers, "Content-Type".":"."application/x-www-form-urlencoded; charset=UTF-8");  
 6 $querys = "";  
 7 $bodys = [  
 8 "app_id"=>'50001',  
 9 "method"=>'cloud.address.cleanse',  
10 "sign"=>"bdf3b5f50865ac813cbdfd6c9b572b79",  
11 "ts"=>'1524209949',  
12 "data"=>'{  
13     "multimode":true,  
14     "address":"山東省煙臺市煙臺市峰哥;上海－上海－長寧;山東－東營－東營區;湖北－恩施土家族苗族自治州－恩施;新疆－和田－和田"  
15 }'  
16 ];  
17 $bodys = http_build_query($bodys);  
18 $url = $host;  
19 $curl = curl_init();  
20 curl_setopt($curl, CURLOPT_CUSTOMREQUEST, $method);  
21 curl_setopt($curl, CURLOPT_URL, $url);  
22 curl_setopt($curl, CURLOPT_HTTPHEADER, $headers);  
23 curl_setopt($curl, CURLOPT_FAILONERROR, false);  
24 curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);  
25 curl_setopt($curl, CURLOPT_HEADER, true);  
26 if (1 == strpos("$".$host, "https://"))  
27 {  
28     curl_setopt($curl, CURLOPT_SSL_VERIFYPEER, false);  
29     curl_setopt($curl, CURLOPT_SSL_VERIFYHOST, false);  
30 }  
31 curl_setopt($curl, CURLOPT_POSTFIELDS, $bodys);  
32 var_dump(curl_exec($curl)); 

成功響應示例（JSON） ↓  

{  
"code":int0  
"msg":string"success"  
"uid":string"a6934adee62d8ba3430d4ac678dd5f46c7a79d6e"  
"data":[  
0:{  
"province":string"山東省"  
"province_code":string"370000"  
"city":string"煙臺市"  
"city_code":string"370600"  
"district":string""  
"district_code":string""  
"address":string"煙臺市峰哥"  
"res":int0  
}  
1:{  
"province":string"上海市"  
"province_code":string"310000"  
"city":string"上海市"  
"city_code":string"310000"  
"district":string"長寧區"  
"district_code":string"310105"  
"address":string""  
"res":int0  
}  
2:{  
"province":string"山東省"  
"province_code":string"370000"  
"city":string"東營市"  
"city_code":string"370500"  
"district":string"東營區"  
"district_code":string"370502"  
"address":string"東營區"  
"res":int0  
}  
3:{  
"province":string"湖北省"  
"province_code":string"420000"  
"city":string"恩施土家族苗族自治州"  
"city_code":string"422800"  
"district":string"恩施市"  
"district_code":string"422801"  
"address":string""  
"res":int0  
}  
4:{  
"province":string"新疆維吾爾自治區"  
"province_code":string"650000"  
"city":string"和田地區"  
"city_code":string"653200"  
"district":string"和田市"  
"district_code":string"653201"  
"address":string""  
"res":int0  
}  
]  
}  

異常響應示例（JSON） ↓   

{  
"code":int400001  
"msg":string"業務參數有誤，請檢查"  
"uid":string"a6934adee62d8ba3430d4ac678dd5f46c7a79d6e"  
"data":{}  
}  

錯誤碼說明  ↓