智能识别快递地址api接口实现（PHP示例）

电商、ERP等行业发货时，批量录入图片上的收件人地址是个难题；智能识别收件人API是近乎完美的解决方案，通过识别图片，解析出图片中收件人的姓名、电话、详细地址（省、市、区/县、详细地址）。将此接口集成到下单环节，可极大的提高了发货效率。

一、使用场景

场景1：客户微信（或QQ、钉钉等）截图收件人信息及地址

场景2：快递单上面的收件人信息及地址

场景3：手写收件人信息及地址

二、智能识别收件人服务使用流程

1、注册快宝开放平台，获取开发者账号，并认证资质：http://open.kuaidihelp.com/home

2、技术对接并调试，对接帮助

3、应用于您软件的下单环节

三、技术对接示例（PHP代码）

智能识别收件人

接口名称：cloud.address.ocr

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

请求方式：HTTP POST

请求方法编码格式：utf-8

公共请求参数：

名称	类型	是否必须	描述
method	string	是	API接口名称
app_id	string	是	用户ID（注册开放平台时分配，在控制台中查看）
sign	string	是	按照规则(md5(app_id + method + ts + api_key))生成的验证合法性签名
ts	string	是	当前请求的时间戳
data	string	是	JSON格式请求参数设置

请求响应参数：

名称	类型	是否必须	描述
code	int	是	响应状态码。0-成功，非0-失败下载并查看详情
msg	string	是	返回结果说明
uid	string	是	本次请求唯一业务流水号
data	string	是	JSON格式响应数据

请求参数：

名称	类型	是否必须	描述
url	string	是	图片地址。带上http或https的前缀

响应参数：

名称	类型	是否必须	描述
name	string	是	名字
mobile	string	是	手机号码
tel	string	是	固定电话
detail	data	是	解析详情
remark	string	是	备注信息
province	string	是	省份
province_alias	string	是	省别名
city	string	是	城市
city_alias	string	是	城市别名
district	string	是	区或县
district_alias	string	是	区或县别名
address	string	是	地址信息

支持Java，C#，Python，PHP，Node.js，Curl等6中语言接入，下面以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"=>'50001',
 "method"=>'cloud.address.ocr',
 "sign"=>"bdf3b5f50865ac813cbdfd6c9b572b79",
 "ts"=>'1524209949',
 "data"=>'{ "url":"http://upload.kuaidihelp.com/1520929251015998700112.jpg" }'
 ];
 $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));

成功响应示例

 {
 "code":int0
 "msg":string"success"
 "data":{
 "name":string"张国明"
 "mobile":string"13522128888"
 "tel":string""
 "detail":{
 "remark":string""
 "province":string"上海市"
 "province_alias":string"上海"
 "city":string"上海市"
 "city_alias":string"上海"
 "district":string"虹口区"
 "district_alias":string"虹口"
 "address":string"广灵一路友谊二村88号502"
 }
 }
 "uid":string"0b767b8f632612c6fbfb44a55d924c6a7f66eedc"
 }

异常响应示例

 {
 "code":string"错误代码"
 "msg":string"错误信息"
 "data":{
 }
 }

错误码

错误码	描述
400001	业务参数有误
400002	超出批量解析最大数量限制
400003	输入字符太少
400004	请求方式错误
400005	请求数据格式错误
400006	缺少必要的参数
400007	类型不合法
400008	不支持的快递品牌

-the end-