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

一、使用场景

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

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

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

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

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为例，展示发送请求任务代码示例。

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.ocr‘,

10 "sign"=>"bdf3b5f50865ac813cbdfd6c9b572b79",

11 "ts"=>‘1524209949‘,

12 "data"=>‘{ "url":"http://upload.kuaidihelp.com/1520929251015998700112.jpg" }‘

13 ];14 $bodys = http_build_query($bodys);15 $url = $host;16 $curl =curl_init();17 curl_setopt($curl, CURLOPT_CUSTOMREQUEST, $method);18 curl_setopt($curl, CURLOPT_URL, $url);19 curl_setopt($curl, CURLOPT_HTTPHEADER, $headers);20 curl_setopt($curl, CURLOPT_FAILONERROR, false);21 curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);22 curl_setopt($curl, CURLOPT_HEADER, true);23 if (1 == strpos("$".$host, "https://"))24 {25 curl_setopt($curl, CURLOPT_SSL_VERIFYPEER, false);26 curl_setopt($curl, CURLOPT_SSL_VERIFYHOST, false);27 }28 curl_setopt($curl, CURLOPT_POSTFIELDS, $bodys);29 var_dump(curl_exec($curl));

成功响应示例

1 {2 "code":int03 "msg":string"success"4 "data":{5 "name":string"张国明"6 "mobile":string"13522128888"7 "tel":string""8 "detail":{9 "remark":string""10 "province":string"上海市"11 "province_alias":string"上海"12 "city":string"上海市"13 "city_alias":string"上海"14 "district":string"虹口区"15 "district_alias":string"虹口"16 "address":string"广灵一路友谊二村88号502"17 }18 }19 "uid":string"0b767b8f632612c6fbfb44a55d924c6a7f66eedc"20 }

异常响应示例

1 {2 "code":string"错误代码"3 "msg":string"错误信息"4 "data":{5 }6 }

错误码

错误码描述

400001

业务参数有误

400002

超出批量解析最大数量限制

400003

输入字符太少

400004

请求方式错误

400005

请求数据格式错误

400006

缺少必要的参数

400007

类型不合法

400008

不支持的快递品牌

-the end-