快遞100API接口開發

api.kuaidi100.com 獲得物流單號的跟蹤信息（免費）

• 1.應用場景
• 2.是否需要授權
• 3.請求地址
• 4.輸入參數
• 5.返回結果
• 6.返回示例
• 7.API工具
• 8.FAQ

通過向指定的地址發送請求，即可返回如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 所支持的快遞公司及參數說明》和《支持的國際類快遞及參數說明》。  如果找不到您所需的公司，請發郵件至 [e-mail] 咨詢（大小寫不敏感）
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：退回，貨物正處於退回發件人的途中； 該狀態還在不斷完善中，若您有更多的參數需求，歡迎發郵件至[e-mail] 提出。
status	查詢結果狀態：  0：物流單暫無結果，  1：查詢成功，  2：接口出現異常，
message	無意義，請忽略
condition	無意義，請忽略
ischeck	無意義，請忽略

6.返回示例

XML格式

            <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) 發郵件到 [e-mail]