标签：http post 编码 contex des PHP代码 java header 查询 express
快递单号查询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 -
快递单号查询免费api接口（PHP示例）
标签：http post 编码 contex des PHP代码 java header 查询 express
原文地址：https://www.cnblogs.com/304dedige/p/8990983.html