智能识别快递地址api接口实现（PHP示例）
标签：开发者账号 rpo 任务 要求 用户id 正式 tab content charset
电商、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为例，展示发送请求任务代码示例。
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":int0
3 "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-
智能识别快递地址api接口实现（PHP示例）
标签：开发者账号 rpo 任务 要求 用户id 正式 tab content charset
原文地址：https://www.cnblogs.com/304dedige/p/9268398.html
评论