微信公众平台消息接口开发(7)快递查询

  1. 云栖社区>
  2. 博客>
  3. 正文

微信公众平台消息接口开发(7)快递查询

方倍工作室 2013-03-12 14:57:00 浏览939
展开阅读全文

微信公众平台消息接口 微信公众平台开发 微信公众平台开发模式  快递查询
作者:方倍工作室
原文:http://www.cnblogs.com/txw1958/archive/2013/03/12/weixin-if7-express.html

 

一、请求数据

快递100提供快递查询接口. 

通过向指定的地址发送请求,即可返回如JSON、XML等格式的跟综结果

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 无意义,请忽略

6.返回示例


JSON格式
{"message":"ok","status":"1","state":"3","data":
[{"time":"2012-07-07 13:35:14","context":"客户已签收"},
 {"time":"2012-07-07 09:10:10","context":"离开 [北京石景山营业厅] 派送中,递送员[温],电话[]"},
 {"time":"2012-07-06 19:46:38","context":"到达 [北京石景山营业厅]"},
 {"time":"2012-07-06 15:22:32","context":"离开 [北京石景山营业厅] 派送中,递送员[温],电话[]"},
 {"time":"2012-07-06 15:05:00","context":"到达 [北京石景山营业厅]"},
 {"time":"2012-07-06 13:37:52","context":"离开 [北京_同城中转站] 发往 [北京石景山营业厅]"},
 {"time":"2012-07-06 12:54:41","context":"到达 [北京_同城中转站]"},
 {"time":"2012-07-06 11:11:03","context":"离开 [北京运转中心驻站班组] 发往 [北京_同城中转站]"},
 {"time":"2012-07-06 10:43:21","context":"到达 [北京运转中心驻站班组]"},
 {"time":"2012-07-05 21:18:53","context":"离开 [福建_厦门支公司] 发往 [北京运转中心_航空]"},
 {"time":"2012-07-05 20:07:27","context":"已取件,到达 [福建_厦门支公司]"}
]} 

 

同时快递100提供Wap版查询接口为 
http://wap.kuaidi100.com/

其URL请求为

http://wap.kuaidi100.com/wap_result.jsp?rand=35447&id=shentong&fromWeb=null&postid=568629598688&sub=%E6%9F%A5%E8%AF%A

 各参数如下:

rand 随机数
id 快递公司名称,此处shentong就是申通
fronweb 是否从web提交
postid 快递号码,此处为 568629598688
sub 一个固定字段, %E6%9F%A5%E8%AF%A2解码后为 查询 两个汉字

因此我们以上面为标准,构造查询请求.

 

二、程序实现

核心代码

 

二、效果演示 

 

更智能的快递查询功能请参考: 微信公众平台消息接口开发(33)智能快递查询

 

欢迎关注方倍工作室微信,了解我们及行业的最新动态

网友评论

登录后评论
0/500
评论
方倍工作室
+ 关注