在好例子网,分享、交流、成长!
您当前所在位置:首页PHP 开发实例PHP语言基础 → 快宝开放平台物流查询接口文档

快宝开放平台物流查询接口文档

PHP语言基础

下载此实例
  • 开发语言:PHP
  • 实例大小:0.03M
  • 下载次数:6
  • 浏览次数:76
  • 发布时间:2022-03-24
  • 实例类别:PHP语言基础
  • 发 布 人:Lizheng500!
  • 文件格式:.docx
  • 所需积分:2
 相关标签: 接口文档 查询 物流 文档 接口

实例介绍

【实例简介】快宝开放平台物流查询接口文档
【实例截图】
API文档/物流跟踪/物流查询

应用场景

1.在电商平台购物后,通过购物订单跟踪物流时,调用此API获取物流信息详情

2.处理运费对账时,一键获取运单物流状态

3.批量跟踪及获取运单物流信息

支持品牌列表下载并查看详情

技术咨询请加微信:kuaibao135

接口名称

express.info.get

公共参数

请求地址

环境名称 HTTPS请求地址
正式地址 https://kop.kuaidihelp.com/api

公共请求参数

名称 类型 是否必须 描述
method string
API接口名称
app_id string
用户ID(注册开放平台时分配,在控制台中查看)
sign string
按照规则(md5(app_id method ts api_key))生成的合法性验证签名(32位字符串,字母小写)如:10000cloud.print.do1524209949bdf3b5f50865ac813cbdfd6c9b572b79加密后5030cae3388ecdc2e686379753a0564c
ts string
当前请求的时间戳(10位或13位)
data string
JSON格式请求参数

公共响应参数

名称 类型 是否必须 描述
code int
响应状态码。0-成功,非0-失败下载并查看详情
msg string
返回结果说明
uid string
本次请求唯一业务流水号
data string
JSON格式响应数据

请求参数

名称 类型 是否必须 描述
waybill_codes string
运单号,多个单号之间用","隔开(英文逗号),最多支持10条
cp_code string
运单号所属快递品牌,需传简称;支持品牌的简称请查看品牌列表下载并查看详情,不传输品牌字段时接口会自动识别品牌后返回结果
result_sort string
返回的物流信息排序(根据物流时间,0-降序排列,1-升序排列,默认值0)
phone string
查顺丰快递时,必填。收发件人,手机号码,后4位(如电话号码13900001234,填写1234即可)

响应参数

名称 类型 是否必须 描述
waybill_code string
运单号
cp_code string
快递公司品牌;支持品牌列表下载并查看详情
status string
物流状态(collected-已揽收;sending-运输中;delivering-派件中;allorgraph-已代收;signed-已签收;question-问题件;)
data array
详细物流信息
order string
物流轨迹顺序,desc 代表降序排列, asc 代表升序排列

请求示例

Java
C#
Python
PHP
Node.js
Curl
import java.security.MessageDigest; import java.security.NoSuchAlgorithmException; import java.util.Map; import java.util.HashMap; import java.util.Date; public class Request { public static void main(String[] args) { String host = "http://kop.kuaidihelp.com"; String path = "/api"; String requestMethod = "POST";
Map<String, String> headers = new HashMap<String, String>(); //根据API的要求,定义相对应的Content-Type headers.put("Content-Type", "application/x-www-form-urlencoded; charset=UTF-8");
Map<String, String> querys = new HashMap<String, String>();
Map<String, String> bodys = new HashMap<String, String>(); String appId = "50001"; String method = "express.info.get"; // 当前时间戳 String ts = new Date().getTime() ""; String appKey = "bdf3b5f50865ac813cbdfd6c9b572b79"; // 计算签名 String signStr = appId   method   ts   appKey; String sign = Request.getMD5(signStr, 32);

bodys.put("app_id", appId);
bodys.put("method", method);
bodys.put("ts", ts);
bodys.put("sign", sign); // data参数是个json格式的字符串  建议使用函数或方法去生成 bodys.put("data", "{ "waybill_codes":"物流单号多个的以英文逗号分隔", "cp_code":"品牌简称","result_sort":"0"}"); try { /**
	* 重要提示如下:
	* HttpUtils请从
	* https://github.com/aliyun/api-gateway-demo-sign-java/blob/master/src/main/java/com/aliyun/api/gateway/demo/util/HttpUtils.java
	* 下载
	*
	* 相应的依赖请参照
	* https://github.com/aliyun/api-gateway-demo-sign-java/blob/master/pom.xml
	*/ HttpResponse response = HttpUtils.doPost(host, path, requestMethod, headers, querys, bodys);
	System.out.println(response.toString()); //获取response的body System.out.println(EntityUtils.toString(response.getEntity()));
	} catch (Exception e) {
		e.printStackTrace();
	}
} // 计算md5 public static String getMD5(String plainText, int length) { try {
            MessageDigest md = MessageDigest.getInstance("MD5");//获取MD5实例 md.update(plainText.getBytes());//此处传入要加密的byte类型值 byte[] digest = md.digest();//此处得到的是md5加密后的byte类型值 /*
               下边的运算就是自己添加的一些二次小加密,记住这个千万不能弄错乱,
                   否则在解密的时候,你会发现值不对的(举例:在注册的时候加密方式是一种,
                在我们登录的时候是不是还需要加密它的密码然后和数据库的进行比对,但是
            最后我们发现,明明密码对啊,就是打不到预期效果,这时候你就要想一下,你是否
             有改动前后的加密方式)   
            */ int i;
            StringBuilder sb = new StringBuilder(); for (int offset = 0; offset < digest.length; offset  ) {
                i = digest[offset]; if (i < 0)
                    i  = 256; if (i < 16)
                    sb.append(0);
                sb.append(Integer.toHexString(i));//通过Integer.toHexString方法把值变为16进制 } return sb.toString().substring(0, length);//从下标0开始,length目的是截取多少长度的值 } catch (NoSuchAlgorithmException e) {
            e.printStackTrace(); return null;
        }
    }
}

响应示例

成功响应示例

JSON示例
{
"code":
int0
"msg":
string"查询成功"
"data":[
0:{
"waybill_code":
string"3339809700595"
"cp_code":
string"sto"
"status":
string"signed"
"data":[
0:{
"time":
string"2017-10-03 19:11:00"
"context":
string"已签收,签收人是代签"
}
1:{
"time":
string"2017-10-03 08:14:33"
"context":
string"快件已到达 浙江浦江公司"
}
2:{
"time":
string"2017-10-03 01:09:41"
"context":
string"由浙江义乌中转部 发往 浙江浦江公司"
}
]
"order":
string"desc"
}
]
}

异常响应示例

JSON示例
{
"code":
string"错误代码"
"msg":
string"错误信息"
"data":{
}
}

错误代码

错误码 描述
201101 查询暂无记录
201102 请求参数错误
201103 不支持的快递品牌

API工具

【核心代码】


实例下载地址

快宝开放平台物流查询接口文档

不能下载?内容有错? 点击这里报错 + 投诉 + 提问

好例子网口号:伸出你的我的手 — 分享

网友评论

发表评论

(您的评论需要经过审核才能显示)

查看所有0条评论>>

小贴士

感谢您为本站写下的评论,您的评论对其它用户来说具有重要的参考价值,所以请认真填写。

  • 类似“顶”、“沙发”之类没有营养的文字,对勤劳贡献的楼主来说是令人沮丧的反馈信息。
  • 相信您也不想看到一排文字/表情墙,所以请不要反馈意义不大的重复字符,也请尽量不要纯表情的回复。
  • 提问之前请再仔细看一遍楼主的说明,或许是您遗漏了。
  • 请勿到处挖坑绊人、招贴广告。既占空间让人厌烦,又没人会搭理,于人于己都无利。

关于好例子网

本站旨在为广大IT学习爱好者提供一个非营利性互相学习交流分享平台。本站所有资源都可以被免费获取学习研究。本站资源来自网友分享,对搜索内容的合法性不具有预见性、识别性、控制性,仅供学习研究,请务必在下载后24小时内给予删除,不得用于其他任何用途,否则后果自负。基于互联网的特殊性,平台无法对用户传输的作品、信息、内容的权属或合法性、安全性、合规性、真实性、科学性、完整权、有效性等进行实质审查;无论平台是否已进行审查,用户均应自行承担因其传输的作品、信息、内容而可能或已经产生的侵权或权属纠纷等法律责任。本站所有资源不代表本站的观点或立场,基于网友分享,根据中国法律《信息网络传播权保护条例》第二十二与二十三条之规定,若资源存在侵权或相关问题请联系本站客服人员,点此联系我们。关于更多版权及免责申明参见 版权及免责申明

;
报警