快递查询 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 所支持的快递公司及参数说明》 。如果找不到您所需的公司，请发邮件至 [email protected] 咨询（大小不敏感）
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、附录

本文档下载地址：

下载地址