api.kuaidi100.com 獲得物流單號的跟蹤信息(免費)
通過向指定的地址發送請求,即可返回如JSON、XML等格式的跟綜結果
- 1、應用場景
- (1)電商網站用戶打開“我的訂單”時調用此API顯示結果
- (2)物流系統對帳前調用此API查一次所有運單的簽收狀態
- 2、是否需要授權
- 是,請到 快遞查詢API申請地址 申請
- 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.返回示例
XML格式
JSON格式
<xml> <message>ok</message> <nu>1200722815552</nu> <ischeck>1</ischeck> <com>yunda</com> <status>1</status> <condition>F00</condition> <data> <time>2013-03-03 19:24:48</time> <context>江蘇泗陽縣公司:進行攬件掃描</context> </data> <data> <time>2013-03-03 19:25:10</time> <context>江蘇泗陽縣公司:進行發出掃描,將發往:江蘇淮安中轉站</context> </data> <data> <time>2013-03-03 21:44:47</time> <context>江蘇淮安中轉站:快件進入分撥中心進行分撥</context> </data> <data> <time>2013-03-04 03:22:44</time> <context>江蘇南京中轉站:從站點發出,本次轉運目的地:江蘇南京棲霞區仙林公司</context> </data> <data> <time>2013-03-04 08:25:03</time> <context>江蘇南京棲霞區仙林公司:到達目的地網點,快件將很快進行派送</context> </data> <data> <time>2013-03-04 13:09:58</time> <context>江蘇南京棲霞區仙林公司:進行派件掃描;派送業務員:孫;(</context> </data> <data> <time>2013-03-04 13:19:47</time> <context>江蘇南京棲霞區仙林公司:快件已被 圖片 簽收</context> </data> <state>3</state> </xml>
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":"已取件,到達 [福建_廈門支公司]"} ]}
7. API工具
>> 快遞100查詢范例ASP版(38.2KB) | 下載 |
>> 快遞100查詢范例PHP版(43.7KB) | 下載 |
>> 快遞100查詢范例.NET版(38.6KB) | 下載 |
>> 快遞100查詢范例JAVA版(8.40KB) | 下載 |
>> Shopex、Ecshop、Hishop和最土團購等快遞查詢插件 | 下載 |
8.FAQ
- (1) 去快遞100博客看看常見問題
- (2) 發郵件到 kuaidi@kingdee.com