api.kuaidi100.com 获得物流单号的跟踪信息(免费)
- 简介:通过向指定的地址发送请求,即可返回如JSON、XML等格式的跟综结果
-
1、应用场景
- (1)电商网站用户打开“我的订单”时调用此API显示结果
- (2)物流系统对帐前调用此API查一次所有运单的签收状态
-
2、是否需要授权
- 是,请到 快递查询API申请地址 申请
-
3、请求地址
- http://api.kuaidi100.com/api?id=[]&com=[]&nu=[]&valicode=[]&show=[0|1|2|3]&muti=[0|1]&order=[desc|asc]
- (使用时请先将上述地址中的 中括号 替换成下面相应的值)
4.输入参数
名称 | 类型 | 是否必需 | 描述 |
---|---|---|---|
id | String | 是 | 身份授权key,请 快递查询接口 进行申请(大小写敏感) |
com | String | 是 | 要查询的快递公司代码,不支持中文,对应的公司代码见 《API URL 所支持的快递公司及参数说明》和《支持的国际类快递及参数说明》。 如果找不到您所需的公司,请发邮件至 kuaidi@kingdee.com 咨询(大小写不敏感) |
nu | String | 是 | 要查询的快递单号,请勿带特殊符号,不支持中文(大小写不敏感) |
valicode | String | 是 | 已弃用字段,无意义,请忽略。 |
show | String | 是 | 返回类型: 0:返回json字符串, 1:返回xml对象, 2:返回html对象, 3:返回text文本。 如果不填,默认返回json字符串。 |
muti | String | 是 | 返回信息数量: 1:返回多行完整的信息, 0:只返回一行信息。 不填默认返回多行。 |
order | String | 是 | 排序: desc:按时间由新到旧排列, asc:按时间由旧到新排列。 不填默认返回倒序(大小写不敏感) |
5.返回结果
字段名称 | 字段含义 |
---|---|
com | 物流公司编号 |
nu | 物流单号 |
time | 每条跟踪信息的时间 |
context | 每条跟综信息的描述 |
state | 快递单当前的状态 : 0:在途,即货物处于运输过程中; 1:揽件,货物已由快递公司揽收并且产生了第一条跟踪信息; 2:疑难,货物寄送过程出了问题; 3:签收,收件人已签收; 4:退签,即货物由于用户拒签、超区等原因退回,而且发件人已经签收; 5:派件,即快递正在进行同城派件; 6:退回,货物正处于退回发件人的途中; 该状态还在不断完善中,若您有更多的参数需求,欢迎发邮件至 kuaidi@kingdee.com 提出。 |
status | 查询结果状态: 0:物流单暂无结果, 1:查询成功, 2:接口出现异常, |
message | 无意义,请忽略 |
condition | 无意义,请忽略 |
ischeck | 无意义,请忽略 |