微信公眾平台消息接口 微信公眾平台開發 微信公眾平台開發模式 快遞查詢
作者：方倍工作室
原文：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）智能快遞查詢
歡迎關注方倍工作室微信，了解我們及行業的最新動態
