智能识别快递地址api接口实现(PHP示例)
Posted 304的的哥
tags:
篇首语:本文由小常识网(cha138.com)小编为大家整理,主要介绍了智能识别快递地址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的前缀
|
响应参数:
名称 | 类型 | 是否必须 | 描述 |
---|---|---|---|
string | 是 |
名字
|
|
string | 是 |
手机号码
|
|
string | 是 |
固定电话
|
|
data | 是 |
解析详情
|
|
string | 是 |
备注信息
|
|
string | 是 |
省份
|
|
string | 是 |
省别名
|
|
string | 是 |
城市
|
|
string | 是 |
城市别名
|
|
string | 是 |
区或县
|
|
string | 是 |
区或县别名
|
|
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示例)的主要内容,如果未能解决你的问题,请参考以下文章