(QQ) 3117725647

快递查询API调用方式
调用简单方便,无需验证码,调用方式:http://q.kdpt.net/api?id=[]&com=[]&nu=[]&show=[]&order=[]&format=[]
一、传入参数:
参数名称类型是否必需描述
idstring 授权密钥,联系客服人员QQ即可申请,无需友情链接,testkey是测试id
com string 快递公司代码,兼容其他查快递接口定义,auto表示自动匹配(建议明确公司以便速度更快)。点击查看支持公司
nustring 运单号
showstring可选返回类型:
json:返回json字符串,
xml:返回xml字符串,
text:返回text字符串,
不传默认值:json
orderstring可选 排序,asc:升序,desc降序,默认是降序。
formatstring可选 兼容返回的格式,目前兼容快递100(format=kuaidi100)、爱快递(format=aikuaidi)、爱查快递(format=ickd)三种。

例如: 中通:http://q.kdpt.net/api?id=testkey&com=zhongtong&nu=370817399305&show=json&order=desc&format=kuaidi100

若不需兼容,建议不用format参数: 中通:http://q.kdpt.net/api?id=testkey&com=zhongtong&nu=370817399305&show=json

二、返回值
{"message":"ok","status":"1","state":"3","com":"zhongtong","nu":"370817399305","data":[{"time":"2015-11-20 13:51:52","context":"北京宣武区 的派件已签收 签收人是 拍照签收"},{"time":"2015-11-20 08:58:18","context":"北京宣武区 的 曾强 正在派件"},{"time":"2015-11-19 04:26:42","context":"快件离开 北京市内部 已发往 北京宣武区"},{"time":"2015-11-16 02:28:01","context":"快件离开 杭州中转部 已发往 北京"},{"time":"2015-11-16 02:25:41","context":"快件已经到达 杭州汽运部 上一站是 杭州钱江开发区"},{"time":"2015-11-15 20:29:36","context":"快件离开 杭州钱江开发区 已发往 北京"},{"time":"2015-11-15 20:29:36","context":"快件离开 杭州钱江开发区 已发往 北京"},{"time":"2015-11-15 19:00:14","context":"杭州钱江开发区 的 米基 已收件"}]}
    返回状态state说明:
    0:在途,即货物处于运输过程中;
    1:揽件,货物已由快递公司揽收并且产生了第一条跟踪信息;
    2:疑难,货物寄送过程出了问题;
    3:签收,收件人已签收;
    4:退签或异常签收,即货物由于用户拒签、超区等原因退回,而且发件人已经签收;
    5:派件,即快递正在进行同城派件;
    6:退回,货物正处于退回发件人的途中;
    返回status说明:
    0:无记录;
    1:查询成功.
三、客户端调用
若是使用java或c#等语言调用,直接采用HTTP的GET方法调用即可。若是使用JavaScript的ajax调用,参考如下: <script src="http://code.jquery.com/jquery-1.9.1.min.js"></script>
<script>
$.support.cors = true;
  $.ajax({
    type: "GET",
    url: "http://q.kdpt.net/api",
    dataType: "jsonp",
    jsonp: "callback",
    jsonpCallback: "success_jsonpCallback",
    data: {id: 'testkey', nu: '805355421423', com: 'yuantong', show:'json' },
    success: function (json) {
      //alert(json.id);
      alert(json.message);//将url及参数输入浏览器地址栏,可以知道返回格式。
      //alert(json.data[0].content);
      alert(json.data[0].context);
    },
    error: function (XMLHttpRequest, textStatus, errorThrown) {
      alert(XMLHttpRequest.status);
      alert(XMLHttpRequest.readyState);
      alert(textStatus);
    },
    complete: function (XMLHttpRequest, textStatus) {
      this;
    }
    });
</script>

四、查快递API支持的公司列表


五、其他快递API
1、预估费用/时间API
调用方式:q.kdpt.net/tpapi?id=testkey&com=shunfeng&sendProv=广东&sendCity=东莞市&sendDistrict=沙田镇&dispProv=江西&dispCity=南昌市&dispDistrict=新建区&weight=1&time=2016-07-15 12:00
参数说明:com是快递公司,目前支持zhongtong和shunfeng,dispProv是目的省份,dispCity是目的地市,sendProv是发出省份,sendCity是发出地市,weight是重量(公斤),对于顺丰,除非直辖市,需要输入到区县,time参数只支持顺丰,可返回给定时间发件的达到时间,如果不输入time,缺省按当前时间计算。另外‘省’、‘市’等字可输入也可不输入。
中通参数也可简化为:q.kdpt.net/tpapi?id=testkey&com=zhongtong&sendProv=广东&sendCity=东莞市&dispProv=江西&dispCity=南昌市&weight=1
返回样例:{"msg":"OK","list":[{"deliverTime":"2016-07-19 18:00","hour":102,"price":18,"firstMoney":"","type":"顺丰隔日"},{"deliverTime":"2016-07-18 18:00","hour":78,"price":22,"firstMoney":"","type":"顺丰次日"}],"status":"true"}
返回说明:msg是返回提示消息,hour是耗时,price是价格,firstMoney是1公斤内的起步价,deliverTime是达到时间,status是true或false表示调用成功失败。firstMoney或deliverTime不一定各公司都提供。
注意事项:由于预估时间API的url含省份等中文字符,因此输入IE浏览器看效果可能乱码,可输入Firefox或chrome浏览器看效果。程序中调用可对url进行编码。

回到首页