智能识别快递地址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的前缀

响应参数:

名称类型是否必须描述
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示例)的主要内容,如果未能解决你的问题,请参考以下文章

.net的快递鸟物流单号自动识别查询api接口demo实例

python实现快递鸟即时查询API接口 数据签名验证

uni-app——小程序实现本地图片的上传以及身份证的智能识别

java对接快递鸟单号查询自动识别接口,调用示例

php 实现快递鸟API接口 快递查询对接签名验证

PHP快递鸟 物流查询接口实现