快遞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 所支援的快遞公司及參數說明》和《支援的國際類快遞及參數說明》。如果找不到您所需的公司，請發郵件至 [email protected] 咨詢（大小寫不敏感）
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：退回，貨物正處于退回發件人的途中；該狀态還在不斷完善中，若您有更多的參數需求，歡迎發郵件至[email protected] 提出。
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) 發郵件到 [email protected]