快宝地址智能解析,批量录入收件人、发件人最好的解决方案,广泛应用于快递行业,电商行业,ERP应用等。
一、对接前准备
注册快宝开放平台,获得开发者账号,查看如何注册。
二、对接联调
快宝开放平台支持多种语言的对接,可以到他们的官网去查看详情。
1.接口描述
接口支持的消息接收方式:HTTP POST
正式API地址:https://kop.kuaidihelp.com/api
返回结果,支持JSON格式。
2. 参数
2.1 请求参数
名称 | 类型 | 是否必须 | 描述 |
---|---|---|---|
multimode | string | 是 |
是否批量(true 为批量,false非批量;默认为true)
|
text | string | 是 |
地址电话姓名字段;批量时各个字段中间用换行符分隔(\n或\r)
|
2.2 响应参数
名称 | 类型 | 是否必须 | 描述 |
---|---|---|---|
original | string | 是 |
请求字段
|
mobile | string | 是 |
手机号码
|
name | string | 是 |
姓名
|
note | string | 是 |
备注
|
province_name | string | 是 |
省级名称
|
province_shortname | string | 是 |
省级简称
|
province_id | string | 是 |
省级行政编码
|
city_name | string | 是 |
市级名称
|
city_shortname | string | 是 |
市级简称
|
city_id | string | 是 |
市级行政编码
|
county_name | string | 是 |
县级名称
|
county_shortname | string | 是 |
县级简称
|
detail | string | 是 |
详细地址
|
phone | string | 是 |
电话
|
3.代码示例
请求参数、响应参数具体详情可到官网查看,同时也支持很多种编程语言(Java,C#,Python,Curl,Node.js),下面是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"=>'你的app_id', 9 "sign"=>"签名", 10 "ts"=>'时间戳', 11 "data"=>'curl -X POST 'https://kop.kuaidihelp.com/api' \ 12 -H 'Content-Type:application/x-www-form-urlencoded;charset=utf-8' \ 13 -d 'app_id=123567890' \ 14 -d 'method=cloud.address.resolve' \ 15 -d 'sign=a528b438fb781cf7b23602edca6cbee5' \ 16 -d 'ts=1519873995' \ 17 -d 'data={ 18 "text":"浙江省绍兴市诸暨市浣东街道西子公寓北区电话:13905857430 衣服 食物 ", 19 "multimode":false 20 }'' 21 ]; 22 $bodys = http_build_query($bodys); 23 $url = $host; 24 $curl = curl_init(); 25 curl_setopt($curl, CURLOPT_CUSTOMREQUEST, $method); 26 curl_setopt($curl, CURLOPT_URL, $url); 27 curl_setopt($curl, CURLOPT_HTTPHEADER, $headers); 28 curl_setopt($curl, CURLOPT_FAILONERROR, false); 29 curl_setopt($curl, CURLOPT_RETURNTRANSFER, true); 30 curl_setopt($curl, CURLOPT_HEADER, true); 31 if (1 == strpos("$".$host, "https://")) 32 { 33 curl_setopt($curl, CURLOPT_SSL_VERIFYPEER, false); 34 curl_setopt($curl, CURLOPT_SSL_VERIFYHOST, false); 35 } 36 curl_setopt($curl, CURLOPT_POSTFIELDS, $bodys); 37 var_dump(curl_exec($curl));
结果响应示例,JSON格式;
1 { 2 "code":int0 3 "msg":string"success" 4 "uid":string"a6934adee62d8ba3430d4ac678dd5f46c7a79d6e" 5 "data":[ 6 0:{ 7 "original":string"浙江省绍兴市诸暨市浣东街道西子公寓北区电话:13905857430 衣服 食物 " 8 "mobile":string"13905857430" 9 "name":string"衣服 食物" 10 "note":string"" 11 "province_id":string"334" 12 "province_name":string"浙江省" 13 "province_shortname":string"浙江" 14 "city_id":string"1304" 15 "city_name":string"绍兴市" 16 "city_shortname":string"绍兴" 17 "county_id":string"1357" 18 "county_name":string"诸暨市" 19 "county_shortname":string"诸暨" 20 "detail":string"浣东街道西子公寓北区" 21 } 22 ] 23 }