快递查询 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：已退货。该状态还在不断完善中，有更多的参数需求，欢迎发邮件至 kuaidi@kingdee.com 提出
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. 发邮件至 kuaidi@kingdee.com，
  2. 论坛，
  3. QQ、电话等：见获得授权key的邮件。

7、附录

本文档下载地址：

下载地址