基于PHP的地址智能解析案例-快宝开放平台

快宝地址智能解析，批量录入收件人、发件人最好的解决方案，广泛应用于快递行业，电商行业，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代码请求示例：

$host = "https://kop.kuaidihelp.com/api";
$method = "POST";
$headers = array();
//根据API的要求，定义相对应的Content-Type
array_push($headers, "Content-Type".":"."application/x-www-form-urlencoded; charset=UTF-8");
$querys = "";
$bodys = [
"app_id"=>'你的app_id',
"sign"=>"签名",
"ts"=>'时间戳',
"data"=>'curl -X POST 'https://kop.kuaidihelp.com/api' \
-H 'Content-Type:application/x-www-form-urlencoded;charset=utf-8' \
-d 'app_id=123567890' \
-d 'method=cloud.address.resolve' \
-d 'sign=a528b438fb781cf7b23602edca6cbee5' \
-d 'ts=1519873995' \
-d 'data={
    "text":"浙江省绍兴市诸暨市浣东街道西子公寓北区电话：13905857430  衣服  食物 ",
    "multimode":false
}''
];
$bodys = http_build_query($bodys);
$url = $host;
$curl = curl_init();
curl_setopt($curl, CURLOPT_CUSTOMREQUEST, $method);
curl_setopt($curl, CURLOPT_URL, $url);
curl_setopt($curl, CURLOPT_HTTPHEADER, $headers);
curl_setopt($curl, CURLOPT_FAILONERROR, false);
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
curl_setopt($curl, CURLOPT_HEADER, true);
if (1 == strpos("$".$host, "https://"))
{
    curl_setopt($curl, CURLOPT_SSL_VERIFYPEER, false);
    curl_setopt($curl, CURLOPT_SSL_VERIFYHOST, false);
}
curl_setopt($curl, CURLOPT_POSTFIELDS, $bodys);
var_dump(curl_exec($curl));

结果响应示例，JSON格式;

{
"code":int0
"msg":string"success"
"uid":string"a6934adee62d8ba3430d4ac678dd5f46c7a79d6e"
"data":[
0:{
"original":string"浙江省绍兴市诸暨市浣东街道西子公寓北区电话：13905857430 衣服 食物 "
"mobile":string"13905857430"
"name":string"衣服 食物"
"note":string""
"province_id":string"334"
"province_name":string"浙江省"
"province_shortname":string"浙江"
"city_id":string"1304"
"city_name":string"绍兴市"
"city_shortname":string"绍兴"
"county_id":string"1357"
"county_name":string"诸暨市"
"county_shortname":string"诸暨"
"detail":string"浣东街道西子公寓北区"
}
]
}