快遞查詢 api

http://code.google.com/p/kuaidi-api/wiki/Open_API_API_URL

更新公告

API的使用說明已遷快遞100網站，要了解Api url使用說明的請點擊快遞100查詢接口說明。

API URL 所支持的快遞公司及參數說明

分類	快遞公司代碼	公司名稱
A
	auspost	澳大利亞郵政(英文結果）
	aae	AAE
	anxindakuaixi	安信達
B
	baifudongfang	百福東方
	bht	BHT
	youzhengguonei	包裹/平郵/掛號信（暫不支持，請轉用Open_API_APICode_URL）
	bangsongwuliu	邦送物流
C
	cces	希伊艾斯（CCES）
	coe	中國東方（COE）
	city100	城市100
	chuanxiwuliu	傳喜物流
	canpost	加拿大郵政Canada Post（英文結果）
	canpostfr	加拿大郵政Canada Post(德文結果）
D
	datianwuliu	大田物流
	debangwuliu	德邦物流
	dpex	DPEX
	dhl	DHL(中文結果）
	dhlen	DHL(英文結果）
	dhlde	DHL（德文結果）
	dsukuaidi	D速快遞
	disifang	遞四方
E
	ems	EMS(中文結果)（需要ems快遞查詢接口的配合）
	ems	E郵寶（需要ems快遞查詢API的配合）
	emsen	EMS（英文結果）需要ems快遞查詢API的配合
F
	fedex	Fedex（國際）（說明：Fedex是國際，國內的請用“lianbangkuaidi”）
	fedexus	FedEx-美國
	feikangda	飛康達物流
	feikuaida	飛快達
	rufengda	凡客如風達
	fengxingtianxia	風行天下
	feibaokuaidi	飛豹快遞
G
	ganzhongnengda	港中能達
	guangdongyouzhengwuliu	廣東郵政
	youzhengguonei	掛號信（暫不支持，請轉用ems快遞接口）
	youzhengguonei	國內郵件（暫不支持，請轉用ems快遞API）
	youzhengguoji	國際郵件（暫不支持，請轉用emsAPI）
	gls	GLS
	gongsuda	共速達
H
	huitongkuaidi	匯通快運
	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）
	lijisong	立即送（暫只能查好樂買的單，其他商家要查，請發郵件至 wensheng_chen#kingdee.com(將#替換成@)開通權限)
	longlangkuaidi	隆浪快遞
M
	minghangkuaidi	民航快遞
	menduimen	門對門
	meiguokuaidi	美國快遞
	mingliangwuliu	明亮物流
O
	ocs	OCS
	ontrac	onTrac
Q
	quanchenkuaidi	全晨快遞
	quanjitong	全際通
	quanritongkuaidi	全日通
	quanyikuaidi	全一快遞
	quanfengkuaidi	全峯快遞
	sevendays	七天連鎖
R
	rufengda	如風達快遞
S
	shentong	申通（暫不支持，請轉用Open_API_APICode_URL）
	shentong	申通E物流（暫不支持，請轉用Open_API_APICode_URL）
	shunfeng	順豐速遞（中文結果）（暫不支持，請轉用Open_API_APICode_URL）
	shunfengen	順豐（英文結果）（暫不支持，請轉用Open_API_APICode_URL）
	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	萬家物流
	wxwl	萬象物流
	weitepai	微特派（暫只能查天天網的單，其他商家要查，請發郵件至 wensheng_chen#kingdee.com(將#替換成@)開通權限)
X
	xinbangwuliu	新邦物流
	xinfengwuliu	信豐物流
	xingchengjibian	星晨急便（暫不支持，請轉用Open_API_APICode_URL）
	xinhongyukuaidi	鑫飛鴻
	cces	希伊艾斯(CCES)
	xinbangwuliu	新邦物流
	neweggozzo	新蛋奧碩物流
	hkpost	香港郵政
Y
	yuantong	圓通速遞
	yunda	韻達快運
	yuntongkuaidi	運通快遞
	youzhengguonei	郵政國內給據（暫不支持，請轉用Open_API_APICode_URL）
	youzhengguoji	郵政國際（需要Open_API_APICode_URL的配合）
	yuanchengwuliu	遠成物流
	yafengsudi	亞風速遞
	yibangwuliu	一邦速遞
	youshuwuliu	優速物流
	yuanweifeng	源偉豐快遞
	yuanzhijiecheng	元智捷誠
	yuefengwuliu	越豐物流
	yuananda	源安達
	yuanfeihangwuliu	原飛航
	zhongxinda	忠信達快遞
	zhimakaimen	芝麻開門
	yinjiesudi	銀捷速遞
	yitongfeihong	一統飛鴻（暫只能查天天網的單，其他商家要查，請發郵件至 wensheng_chen#kingdee.com(將#替換成@)開通權限)
Z
	zhongtong	中通速遞
	zhaijisong	宅急送
	ztky	中鐵快運
	zhongtiewuliu	中鐵物流
	zhongyouwuliu	中郵物流
	zhongxinda	忠信達
	zhongsukuaidi	中速快件
	zhimakaimen	芝麻開門
	zhengzhoujianhua	鄭州建華（暫只能查好樂買的單，其他商家要查，請發郵件至 wensheng_chen#kingdee.com(將#替換成@)開通權限）
	zhongtianwanyun	中天萬運

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：已退貨。該狀態還在不斷完善中，有更多的參數需求，歡迎發郵件至 [email protected] 提出
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. 發郵件至 [email protected]，
  2. 論壇，
  3. QQ、電話等：見獲得授權key的郵件。

7、附錄

本文檔下載地址：

下載地址