快递查询
经常有应用需求能根据单号查询快递状态,大多数时候都需求快递的运输信息。我们可以从 快递 100 中快速的获取到快递的物流信息。
接口分析
快递 100 中提供了两个接口用来结合查询物流信息:
- 根据单号智能识别物流方式(顺丰、韵达、申通等)
- 根据单号及物流方式获取物流信息
智能识别接口
接口地址: http://www.kuaidi100.com/autonumber/autoComNum?text=[单号]
请求方式: GET
接口返回:
成功返回:
{ "comCode": "", "num": "3310479082803", "auto": [ { "comCode": "shentong", "id": "", "noCount": 94165, "noPre": "331047", "startTime": "" } ] }
如果是不能识别的单号那么将返回:
{ "comCode": "", "num": "xxx51017908280", "auto": [] }
物流详情接口
接口地址: http://www.kuaidi100.com/query?type=[comCode]&postid=[单号]&id=1&valicode=&temp=[时间戳]
请求方式: GET
接口返回信息:
{ "message": "ok", "nu": "3310479082803", "ischeck": "0", "com": "shentong", "updatetime": "2016-07-27 13:15:45", "status": "200", "condition": "00", "data": [ { "time": "2016-06-30 03:17:28", "location": "", "context": "快件已到达 湖北武汉武隆分部", "ftime": "2016-06-30 03:17:28" }, { "time": "2016-06-29 16:35:02", "location": "", "context": "由 浙江杭州中转部 发往 安徽黄山公司", "ftime": "2016-06-29 16:35:02" }, { "time": "2016-06-29 16:22:00", "location": "", "context": "由 湖北武汉航空部 发往 湖北武汉武隆分部", "ftime": "2016-06-29 16:22:00" }, { "time": "2016-06-28 23:09:29", "location": "", "context": "由 湖北武汉航空部 发往 浙江杭州中转部", "ftime": "2016-06-28 23:09:29" }, { "time": "2016-06-28 20:03:09", "location": "", "context": "由 湖北武汉航空部 发往 浙江杭州中转部", "ftime": "2016-06-28 20:03:09" }, { "time": "2016-06-28 20:03:09", "location": "", "context": "湖北武汉航空部 正在进行 装袋 扫描", "ftime": "2016-06-28 20:03:09" }, { "time": "2016-06-28 20:02:52", "location": "", "context": "由 湖北武汉航空部 发往 浙江杭州中转部", "ftime": "2016-06-28 20:02:52" }, { "time": "2016-06-28 19:58:24", "location": "", "context": "快件已到达 湖北武汉航空部", "ftime": "2016-06-28 19:58:24" }, { "time": "2016-06-28 17:12:28", "location": "", "context": "湖北武汉公司(027-83225888) 的收件员 汉口吴燕飞 已收件", "ftime": "2016-06-28 17:12:28" } ], "state": "0" }
异常返回:
{ "status": "403", "message": "快递公司参数异常:单号格式错误" }