通过向指定的地址发送请求,即可返回如JSON、XML等格式的跟综结果
(1)电商网站用户打开"我的订单"时调用此API显示结果
(2)物流系统对帐前调用此API查一次所有运单的签收状态
是,请到 快递查询API申请地址 申请
http://api.kuaidi.com/openapi.html?id=[]&com=[]&nu=[]&show=[0|1]&muti=[0|1]&order=[desc|asc]
(使用时请先将上述地址中的 中括号 替换成下面相应的值)
名称 | 类型 | 是否必需 | 描述 |
---|---|---|---|
id | String | 是 | 身份授权key,请 快递查询接口 进行申请(大小写敏感) |
com | String | 是 | 要查询的快递公司代码,不支持中文,对应的公司代码见 《kuaidi_api》。 如果找不到您所需的公司,请发邮件至 zhangxiaoyu@kuaidi.com 咨询(大小写不敏感) |
nu | String | 是 | 要查询的快递单号,请勿带特殊符号,不支持中文(大小写不敏感) |
show | String | 是 | 返回类型: 0:返回json字符串, 1:返回xml对象, 如果不填,默认返回json字符串。 |
muti | String | 是 | 返回信息数量: 0:返回多行完整的信息, 1:只返回一行信息。 不填默认返回多行。 |
order | String | 是 | 排序: desc:按时间由新到旧排列, asc:按时间由旧到新排列。 不填默认由新到旧排列(大小写不敏感) |
字段名称 | 字段含义 |
---|---|
success | 返回状态:true 成功,false 失败 |
status | 快递单当前状态: 0:物流单号暂无结果; 3:在途,快递处于运输过程中; 4:揽件,快递已被快递公司揽收并产生了第一条信息; 5:疑难,快递邮寄过程中出现问题; 6:签收,收件人已签收; 7:退签,快递因用户拒签、超区等原因退回,而且发件人已经签收; 8:派件,快递员正在同城派件; 9:退回,货物处于退回发件人途中; |
reason | 如果请求失败,发送相应失败代码 |
data | 数据集合 |
time | 每条数据时间 |
context | 每条数据内容 |
<result> <success>true</success> <reason /> <data> <time>2015-10-05 18:22:53</time> <context> 已签收,签收人是:本人 </context> </data> <data> <time>2015-10-05 08:52:18</time> <context> 山东即墨公司 的派件员高广照正在派件 </context> </data> <data> <time>2015-10-04 12:54:26</time> <context> 由山东潍坊中转部 发往山东即墨公司 </context> </data> <data> <time>2015-10-03 23:27:55</time> <context> 由上海航空部 发往山东潍坊公司 </context> </data> <data> <time>2015-10-03 19:42:58</time> <context> 由江苏吴江公司 发往上海航空部 </context> </data> <data> <time>2015-10-03 19:33:55</time> <context> 江苏吴江公司 正在进行装袋扫描 </context> </data> <data> <time>2015-10-03 19:33:55</time> <context> 由江苏吴江公司 发往上海航空部 </context> </data> <data> <time>2015-10-03 19:24:58</time> <context> 江苏吴江公司 的收件员黎里片区淘宝已收件 </context> </data> <status>6</status> </result>
{ "success":true,"reason":"","data": [{"time":"2015-10-20 18:35:13", "context":"\u5df2\u7b7e\u6536,\u7b7e\u6536\u4eba\u662f:\u95e8\u536b\u7b7e\u6536" }, {"time":"2015-10-20 10:20:17", "context":"\u56db\u5ddd\u8fbe\u5dde\u5927\u7af9\u516c\u53f8\r\r\u7684\u6d3e\u4ef6\u5458\u 718a\u59d0\u6b63\u5728\u6d3e\u4ef6" }, { "time":"2015-10-20 09:40:40", "context":"\u5feb\u4ef6\u5df2\u5230\u8fbe\u56db\u5ddd\u8fbe\u5dde\u5927\u7af9\u516c\u53f8" }, {"time":"2015-10-20 03:00:23", "context":"\u56db\u5ddd\u5357\u5145\u4e2d\u8f6c\u90e8\r\r\u6b63\u5728\u8fdb\u884c\u88c5\u8 f66\u626b\u63cf" }, {"time":"2015-10-20 03:00:23", "context":"\u7531\u56db\u5ddd\u5357\u5145\u4e2d\u8f6c\u90e8\r\r\u53d1\u5f80\u56db\u5ddd\u8 fbe\u5dde\u5927\u7af9\u516c\u53f8" }, {"time":"2015-10-17 23:49:41", "context":"\u7531\u4e0a\u6d77\u822a\u7a7a\u90e8\r\r\u53d1\u5f80\u56db\u5ddd\u6210\u90fd\u8 22a\u7a7a\u90e8" }, {"time":"2015-10-17 21:10:16", "context":"\u7531\u6c5f\u82cf\u5434\u6c5f\u516c\u53f8\r\r\u53d1\u5f80\u4e0a\u6d77\u822a\u7 a7a\u90e8" }, {"time":"2015-10-17 20:57:19", "context":"\u7531\u6c5f\u82cf\u5434\u6c5f\u516c\u53f8\r\r\u53d1\u5f80\u4e0a\u6d77\u822a\u7 a7a\u90e8" }, {"time":"2015-10-17 20:57:19", "context":"\u6c5f\u82cf\u5434\u6c5f\u516c\u53f8\r\r\u6b63\u5728\u8fdb\u884c\u88c5\u888b\u6 26b\u63cf" }, {"time":"2015-10-17 20:23:17", "context":"\u6c5f\u82cf\u5434\u6c5f\u516c\u53f8\r\r\u7684\u6536\u4ef6\u5458\u9ece\u91cc\u7 247\u533a\u6dd8\u5b9d\u5df2\u6536\u4ef6" }], "status":6 }
(1) 企业QQ: 2885643506
(2) API用户交流群: 524654214
(3) 发邮件到: caijinghua@kuaidi.com