用快遞100接口查詢各快遞物流信息

1、API地址

http://api.kuaidi100.com/api?id=[]&com=[]&nu=[]&valicode=[]&show=[0|1|2|3]&muti=[0|1]&order=[desc|asc]

注：為了防止惡意解釋的情況，不能通過IP訪問本網站及API，敬請原諒

2、輸入參數說明

名稱	類型	是否必需	描述
id	String	是	身份授權Key，請點 快遞查詢接口 進行申請（大小敏感）
com	String	是	要查詢的快遞公司代碼，不支持中文， 對應的公司代碼見后面第7章的《API URL 所支持的快遞公司及參數說明》 。如果找不到您所需的公司，請發郵件至 kuaidi@kingdee 咨詢（大小不敏感）
nu	String	是	要查詢的快遞單號，請勿帶特殊符號，不支持中文（大小不敏感）
valicode	String	否	查詢快遞的電話號碼，目前只有佳吉物流需要這個參數，其他公司請忽略
show	String	否	返回類型。0：返回json字符串，1：返回xml對象，2：返回html對象，3：返回text文本。如果不填，默認返回json字符串
muti	Stirng	是	返回信息數量，1:返回多行完整的信息，0:只返回一行信息。不填默認返回多行
order	Stirng	否	排序。desc：按時間由新到舊排列，asc：按時間由舊到新排列。不填默認返回倒序（大小不敏感）

3、返回結果說明

字段名稱	字段含義
Message	消息體
Data	數據集合
Time	每條數據的時間
Context	每條數據的狀態
state	快遞單當前的狀態 。0：在途中,1：已發貨，2：疑難件，3： 已簽收 ，4：已退貨。該狀態還在不斷完善中，有更多的參數需求，歡迎發郵件至 [e-mail] 提出
status	查詢的結果狀態。0：運單暫無結果，1：查詢成功，2：接口出現異常，408：驗證碼出錯（僅適用於APICode url，可忽略) 。遇到其他情況，請按獲得身份授權key的郵件中的方法獲得技術支持。

4、API調用及返回結果示范

4.1 API調用示范

http://api.kuaidi100.com/api?id=xxxxxxxxxxxxx&com=tiantian&nu=11111&show=0&muti=1&order=desc

4.2 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":"已取件，到達 [福建_廈門支公司]"}]}

4.3 xml返回示例

<xml>
        <message>ok</message>
        <status>1</status>
        <state>3</state>
        <data>
                <time>2012-07-07 13:35:14</time>
                <context>客戶已簽收</context>
        </data>
        <data>
                <time>2012-07-07 09:10:10</time>
                <context>離開 [北京_房山營業所_石景山營業廳] 派送中，遞送員[溫]，電話[]</context>
        </data>
        <data>
                <time>2012-07-06 19:46:38</time>
                <context>到達 [北京_房山營業所_石景山營業廳]</context></data><data><time>2012-07-06 15:22:32</time>
                <context>離開 [北京_房山營業所_石景山營業廳] 派送中，遞送員[溫]，電話[]</context>
        </data>
        <data>
                <time>2012-07-06 15:05:00</time>
                <context>到達 [北京_房山營業所_石景山營業廳]</context>
        </data>
        <data>
                <time>2012-07-06 13:37:52</time>
                <context>離開 [北京_同城中轉站] 發往 [北京_房山營業所_石景山營業廳]</context>
        </data>
        <data>
                <time>2012-07-06 12:54:41</time>
                <context>到達 [北京_同城中轉站]</context>
        </data>
        <data>
                <time>2012-07-06 11:11:03</time>
                <context>離開 [北京運轉中心_航空_駐站班組] 發往 [北京_同城中轉站]</context>
        </data>
        <data>
                <time>2012-07-06 10:43:21</time>
                <context>到達 [北京運轉中心_航空_駐站班組]</context>
        </data>
        <data>
                <time>2012-07-05 21:18:53</time>
                <context>離開 [福建_廈門支公司] 發往 [北京運轉中心_航空]</context></data>
        <data>
                <time>2012-07-05 20:07:27</time>
                <context>已取件，到達 [福建_廈門支公司]</context>
        </data>
</xml>

4.4 html返回示例

如下圖照片所示，如果沒有看到圖片，請稍等或刷新本頁：

4.5 text返回示例

時間 地點和跟蹤進度
2012-07-07 13:35:14     客戶已簽收
2012-07-07 09:10:10     離開 [北京_房山營業所_石景山營業廳] 派送中，遞送員[溫]，電話[]
2012-07-06 19:46:38     到達 [北京_房山營業所_石景山營業廳]
2012-07-06 15:22:32     離開 [北京_房山營業所_石景山營業廳] 派送中，遞送員[溫]，電話[]
2012-07-06 15:05:00     到達 [北京_房山營業所_石景山營業廳]
2012-07-06 13:37:52     離開 [北京_同城中轉站] 發往 [北京_房山營業所_石景山營業廳]
2012-07-06 12:54:41     到達 [北京_同城中轉站]
2012-07-06 11:11:03     離開 [北京運轉中心_航空_駐站班組] 發往 [北京_同城中轉站]
2012-07-06 10:43:21     到達 [北京運轉中心_航空_駐站班組]
2012-07-05 21:18:53     離開 [福建_廈門支公司] 發往 [北京運轉中心_航空]
2012-07-05 20:07:27     已取件，到達 [福建_廈門支公司]

 

5、開發案例及插件支持

• 目前提供ASP、ASP.NET、PHP和Java等四個版本的開發實例，請點快遞查詢開發示范下載。

• 插件下載請點:快遞查詢插件

 

6、FAQ及技術支持

• FAQ：請點 快遞查詢接口(API)常見問題

• 技術支持：
  1. 發郵件至 [e-mail]，
  2. 論壇，
  3. QQ、電話等：見獲得授權key的郵件。

 

出現“快遞公司網絡異常，請稍后查詢”，是因為api.kuaidi100.com這種API不支持EMS、順豐、圓通、中通和韻達等幾家，我們的支持列表中有說明:這幾家建議用另一種API：
1、切換到【跳轉API】（免費，無需申請，跳轉到快遞100的網頁顯示結果）:

http://www.kuaidi100.com/openapi/api_3_02.shtml
2、切換到【手機API】（免費，無需申請，跳轉到快遞100手機站顯示結果）： http://www.kuaidi100.com/openapi/mobileapi.shtml
3、切換到【iframe頁】（免費，無需申請，嵌套頁面，無法自定義公司和運單號）： http://www.kuaidi100.com/app/code.shtml
4、切換到【HtmlAPI】（免費，和api.kuaidi100.com共用Key，可自定義公司和運單號，嵌套頁面顯示結果，有快遞100廣告）：
http://www.kuaidi100.com/download/html_api(20140729).doc
5、付費方案（無限制），要了解請回復公司名、網站

 

7、附錄

本文檔下載地址：

下載地址

 

8、 物流編碼

說明

以下是快遞100對外開放的部份公司的列表，同時適用於HtmlAPI和 運單查詢API（部份，具體區別請留意快遞公司名稱后的備注），另外國際類的可以直接點擊國際郵政、EMS、快遞類列表查看。

由於我們並沒有將所有公司完全對外公布，如果在下面沒有找到您所要的快遞公司，請添加企業QQ 800036857轉 小佰或 發郵件至 [e-mail] 咨詢。

分類	快遞公司代碼	公司名稱
A
	auspost	澳大利亞郵政(英文結果）
	aae	AAE
	anxindakuaixi	安信達
B
	huitongkuaidi	百世匯通
	baifudongfang	百福東方
	bht	BHT
	youzhengguonei	包裹/平郵/掛號信（暫只支持HtmlAPI,要JSON、XML格式結果和簽收狀態state請聯系企業QQ 800036857轉“小佰”）
	bangsongwuliu	邦送物流
C
	cces	希伊艾斯（CCES）
	coe	中國東方（COE）
	chuanxiwuliu	傳喜物流
	canpost	加拿大郵政Canada Post（英文結果）
	canpostfr	加拿大郵政Canada Post(德文結果）
D
	datianwuliu	大田物流
	debangwuliu	德邦物流
	dpex	DPEX
	dhl	DHL-中國件-中文結果
	dhlen	DHL-國際件-英文結果
	dhlde	DHL-德國件-德文結果（德國國內派、收的件）
	dsukuaidi	D速快遞
	disifang	遞四方
E
	ems	EMS(中文結果)（暫只支持HtmlAPI,要JSON、XML格式結果和簽收狀態state請聯系企業QQ 800036857 轉“小佰”）
	ems	E郵寶（暫只支持HtmlAPI,要JSON、XML格式結果和簽收狀態state請聯系企業QQ 800036857 轉“小佰”）
	emsen	EMS（英文結果）（暫只支持HtmlAPI,要JSON、XML格式結果和簽收狀態state請聯系企業QQ 800036857 轉“小佰”）
	emsguoji	EMS-（中國-國際）件-中文結果/EMS-(China-International）-Chinese data(請聯系企業QQ 800036857 轉“小佰”開通）
	emsinten	EMS-（中國-國際）件-英文結果/EMS-(China-International）-Englilsh data(請聯系企業QQ 800036857 轉“小佰”開通）
F
	fedex	Fedex-國際件-英文結果（說明：Fedex是國際件的英文結果，Fedex中國的請用“lianbangkuaidi”，Fedex-美國請用fedexus）
	fedexcn	Fedex-國際件-中文結果
	fedexus	Fedex-美國件-英文結果(說明：如果無效，請償試使用fedex）
	feikangda	飛康達物流
	feikuaida	飛快達
	rufengda	凡客如風達
	fengxingtianxia	風行天下
	feibaokuaidi	飛豹快遞
G
	ganzhongnengda	港中能達
	guotongkuaidi	國通快遞
	guangdongyouzhengwuliu	廣東郵政
	youzhengguonei	掛號信（暫只支持HtmlAPI,要JSON、XML格式結果和簽收狀態state請聯系企業QQ 800036857 轉“小佰”）
	youzhengguonei	國內郵件（暫只支持HtmlAPI,要JSON、XML格式結果和簽收狀態state請聯系企業QQ 800036857 轉“小佰”）
	youzhengguoji	國際郵件（暫只支持HtmlAPI,要JSON、XML格式結果和簽收狀態state請聯系企業QQ 800036857 轉“小佰”）
	gls	GLS
	gongsuda	共速達
H
	huitongkuaidi	匯通快運
	huiqiangkuaidi	匯強快遞
	tiandihuayu	華宇物流
	hengluwuliu	恆路物流
	huaxialongwuliu	華夏龍
	tiantian	海航天天
	haiwaihuanqiu	海外環球
	hebeijianhua	河北建華（暫只能查好樂買的單，其他商家要查，請發郵件至 wensheng_chen#kingdee.com(將#替換成@)開通權限
	haimengsudi	海盟速遞
	huaqikuaiyun	華企快運
	haihongwangsong	山東海紅
J
	jiajiwuliu	佳吉物流
	jiayiwuliu	佳怡物流
	jiayunmeiwuliu	加運美
	jinguangsudikuaijian	京廣速遞
	jixianda	急先達
	jinyuekuaidi	晉越快遞
	jietekuaidi	捷特快遞
	jindawuliu	金大物流
	jialidatong	嘉里大通
K
	kuaijiesudi	快捷速遞
	kangliwuliu	康力物流
	kuayue	跨越物流
L
	lianhaowuliu	聯昊通
	longbanwuliu	龍邦物流
	lanbiaokuaidi	藍鏢快遞
	lejiedi	樂捷遞（暫只能查好樂買的單，其他商家要查，請發郵件至 wensheng_chen#kingdee.com(將#替換成@)開通權限
	lianbangkuaidi	聯邦快遞（Fedex-中國-中文結果）（說明：國外的請用 fedex）
	lianbangkuaidien	聯邦快遞(Fedex-中國-英文結果）
	lijisong	立即送（暫只能查好樂買的單，其他商家要查，請發郵件至 wensheng_chen#kingdee.com(將#替換成@)開通權限)
	longlangkuaidi	隆浪快遞
M
	menduimen	門對門
	meiguokuaidi	美國快遞
	mingliangwuliu	明亮物流
O
	ocs	OCS
	ontrac	onTrac
Q
	quanchenkuaidi	全晨快遞
	quanjitong	全際通
	quanritongkuaidi	全日通
	quanyikuaidi	全一快遞
	quanfengkuaidi	全峰快遞
	sevendays	七天連鎖
R
	rufengda	如風達快遞
S
	shentong	伸通（暫只支持HtmlAPI,要JSON、XML格式結果和簽收狀態state請聯系企業QQ 800036857 轉“小佰”）
	shunfeng	順豐速遞（中文結果）（暫只支持HtmlAPI,要JSON、XML格式結果和簽收狀態state請聯系企業QQ 800036857 轉“小佰”）
	shunfengen	順豐（英文結果）（暫只支持HtmlAPI,要JSON、XML格式結果和簽收狀態state請聯系企業QQ 800036857 轉“小佰”）
	santaisudi	三態速遞
	shenghuiwuliu	盛輝物流
	suer	速爾物流
	shengfengwuliu	盛豐物流
	shangda	上大物流
	santaisudi	三態速遞
	haihongwangsong	山東海紅
	saiaodi	賽澳遞
	haihongwangsong	山東海紅（暫只能查好樂買的單，其他商家要查，請發郵件至 wensheng_chen#kingdee.com(將#替換成@)開通權限）
	sxhongmajia	山西紅馬甲（暫只能查天天網的單，其他商家要查，請發郵件至 wensheng_chen#kingdee.com(將#替換成@)開通權限)
	shenganwuliu	聖安物流
	suijiawuliu	穗佳物流
T
	tiandihuayu	天地華宇
	tiantian	天天快遞
	tnt	TNT（中文結果）
	tnten	TNT（英文結果）
	tonghetianxia	通和天下（暫只能查好樂買的單，其他商家要查，請發郵件至 wensheng_chen#kingdee.com(將#替換成@)開通權限）
U
	ups	UPS（中文結果）
	upsen	UPS（英文結果）
	youshuwuliu	優速物流
	usps	USPS（中英文）
W
	wanjiawuliu	萬家物流
	wanxiangwuliu	萬象物流
	weitepai	微特派（暫只能查天天網的單，其他商家要查，請發郵件至 wensheng_chen#kingdee.com(將#替換成@)開通權限)
X
	xinbangwuliu	新邦物流
	xinfengwuliu	信豐物流
	xingchengjibian	星晨急便（暫不支持，該公司已不存在）
	xinhongyukuaidi	鑫飛鴻（暫不支持，該公司已不存在）
	cces	希伊艾斯(CCES)（暫不支持，該公司已不存在）
	xinbangwuliu	新邦物流
	neweggozzo	新蛋奧碩物流
	hkpost	香港郵政
Y
	yuantong	圓通速遞（暫只支持HtmlAPI,要JSON、XML格式結果和簽收狀態state請聯系企業QQ 800036857 轉“小佰”）
	yunda	韻達快運（暫只支持HtmlAPI,要JSON、XML格式結果和簽收狀態state請聯系企業QQ 800036857 轉“小佰”）
	yuntongkuaidi	運通快遞
	youzhengguonei	郵政小包（國內），郵政包裹（國內）、郵政國內給據（國內）（暫只支持HtmlAPI,要JSON、XML格式結果和簽收狀態state請聯系企業QQ 800036857 轉“小佰”）
	youzhengguoji	郵政小包（國際），郵政包裹（國際）、郵政國內給據（國際）（暫只支持HtmlAPI,要JSON、XML格式結果和簽收狀態state請聯系企業QQ 800036857 轉“小佰”）
	yuanchengwuliu	遠成物流
	yafengsudi	亞風速遞
	yibangwuliu	一邦速遞
	youshuwuliu	優速物流
	yuanweifeng	源偉豐快遞
	yuanzhijiecheng	元智捷誠
	yuefengwuliu	越豐物流
	yuananda	源安達
	yuanfeihangwuliu	原飛航
	zhongxinda	忠信達快遞
	zhimakaimen	芝麻開門
	yinjiesudi	銀捷速遞
	yitongfeihong	一統飛鴻（暫只能查天天網的單，其他商家要查，請發郵件至 wensheng_chen#kingdee.com(將#替換成@)開通權限)
Z
	zhongtong	中通速遞（暫只支持HtmlAPI,要JSON、XML格式結果和簽收狀態state請聯系企業QQ 800036857 轉“小佰”）
	zhaijisong	宅急送
	zhongyouwuliu	中郵物流
	zhongxinda	忠信達
	zhongsukuaidi	中速快件
	zhimakaimen	芝麻開門
	zhengzhoujianhua	鄭州建華（暫只能查好樂買的單，其他商家要查，請發郵件至 wensheng_chen#kingdee.com(將#替換成@)開通權限）
	zhongtianwanyun	中天萬運