大家好,欢迎来到IT知识分享网。
快递单号查询API,可以对接顺丰快递查询,邮政快递查询,中通快递查询等。这些快递物流企业,提供了快递单号自动识别接口,快递单号查询接口等快递物流服务。对于电商企业,ERP服务企业,集成此接口到自己的软件中,增加了企业的竞争力。但是有个缺点,需要分别对接到各大快递公司,分别调试接口,维护成本高,不方便管理等。推荐一个提供快递查询api免费对接的服务平台,快宝开放平台。
一、接口应用场景
1.在电商平台购物后,通过购物订单跟踪物流时,调用此API获取物流信息详情
2.处理运费对账时,一键获取运单物流状态
3.批量跟踪及获取运单物流信息
二、对接准备
1.注册快宝开放平台,注册地址:http://open.kuaidihelp.com/register
2.获取开发者账号信息(ID ,API Key),在【控制台】中查看
3.进行技术联调,并完成调试,物流查询api地址:http://open.kuaidihelp.com/api/1003
4.在您的软件中集成快递物流查询接口
三、技术对接
快宝开放平台提供的快递查询接口,支持110多家快递物流查询,涵盖了国内主流快递服务企业的单号查询,信息及时,数据完整。
接口名称:express.info.get
正式地址: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格式响应数据
|
请求参数 ↓
名称 | 类型 | 是否必输 | 描述 |
waybill_no | string | 是 | 物流单号,多个单号之间用”,”隔开,最多支持10条 |
exp_company_code | string | 是 | 支持品牌简称请查看品牌列表下载并查看详情 |
响应参数 ↓
名称 | 类型 | 是否必须 | 描述 |
---|---|---|---|
code | int | 是 |
响应状态码。0-成功,非0-失败
|
msg | string | 是 |
返回结果说明
|
data | string | 是 |
JSON格式响应数据
|
请求代码示例 ↓
支持6中开发语言对接,包括JAVA,C#,PHP,Python,Node.js,Crul;根据您的开发语言,选择参考对应的代码示例,下面以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"=>'express.info.get', 10 "sign"=>"bdf3b5f50865ac813cbdfd6c9b572b79", 11 "ts"=>'1524209949', 12 "data"=>'{ "waybill_no":"物流单号多个的以英文逗号分隔", "exp_company_code":"品牌简称"}' 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));
成功响应示例 ↓
响应(成功、失败)示例,仅支持JSON格式。
1 { 2 "code":int0 3 "msg":string"查询成功" 4 "data":[ 5 0:{ 6 "no":string"3339809700595" 7 "brand":string"sto" 8 "status":string"signed" 9 "data":[ 10 0:{ 11 "time":string"2017-10-03 19:11:00" 12 "context":string"已签收,签收人是代签" 13 } 14 1:{ 15 "time":string"2017-10-03 08:14:33" 16 "context":string"快件已到达 浙江浦江公司" 17 } 18 2:{ 19 "time":string"2017-10-03 01:09:41" 20 "context":string"由浙江义乌中转部 发往 浙江浦江公司" 21 } 22 ] 23 "order":string"desc" 24 } 25 ] 26 }
失败响应示例 ↓
1 { 2 "code":string"错误代码" 3 "msg":string"错误信息" 4 "data":{} 5 }
错误码
错误码 | 描述 |
---|---|
201102 | 请求参数错误 |
201103 | 不支持的快递品牌 |
201101 | 查询暂无记录 |
– the end –
免责声明:本站所有文章内容,图片,视频等均是来源于用户投稿和互联网及文摘转载整编而成,不代表本站观点,不承担相关法律责任。其著作权各归其原作者或其出版社所有。如发现本站有涉嫌抄袭侵权/违法违规的内容,侵犯到您的权益,请在线联系站长,一经查实,本站将立刻删除。 本文来自网络,若有侵权,请联系删除,如若转载,请注明出处:https://yundeesoft.com/34919.html