快递查询 api

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

更新公告

API的使用说明已迁快递100网站，要了解Api url使用说明的请点击快递100查询接口说明。

API URL 所支持的快递公司及参数说明

分类快递公司代码公司名称A   auspost澳大利亚邮政(英文结果） aaeAAE anxindakuaixi安信达B   baifudongfang百福东方 bhtBHT youzhengguonei包裹/平邮/挂号信（暂不支持，请转用Open_API_APICode_URL） bangsongwuliu邦送物流C   cces希伊艾斯（CCES） coe中国东方（COE） city100城市100 chuanxiwuliu传喜物流 canpost加拿大邮政Canada Post（英文结果） canpostfr加拿大邮政Canada Post(德文结果）D   datianwuliu大田物流 debangwuliu德邦物流 dpexDPEX dhlDHL(中文结果） dhlenDHL(英文结果） dhldeDHL（德文结果） dsukuaidiD速快递 disifang递四方E   emsEMS(中文结果)（需要ems快递查询接口的配合） emsE邮宝（需要ems快递查询API的配合） emsenEMS（英文结果）需要ems快递查询API的配合F   fedexFedex（国际）（说明：Fedex是国际，国内的请用“lianbangkuaidi”） fedexusFedEx-美国 feikangda飞康达物流 feikuaida飞快达 rufengda凡客如风达 fengxingtianxia风行天下 feibaokuaidi飞豹快递G   ganzhongnengda港中能达 guangdongyouzhengwuliu广东邮政 youzhengguonei挂号信（暂不支持，请转用ems快递接口） youzhengguonei国内邮件（暂不支持，请转用ems快递API） youzhengguoji国际邮件（暂不支持，请转用emsAPI） glsGLS 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   ocsOCS ontraconTracQ   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天天快递 tntTNT（中文结果） tntenTNT（英文结果） tonghetianxia通和天下（暂只能查好乐买的单，其他商家要查，请发邮件至 wensheng_chen#kingdee.com(将#替换成@)开通权限）U   upsUPS（中文结果） upsenUPS（英文结果） youshuwuliu优速物流 uspsUSPS（中英文）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、输入参数说明

名称类型是否必需描述idString是身份授权Key，请点 快递查询接口 进行申请（大小敏感）comString是要查询的快递公司代码，不支持中文， 对应的公司代码见后面第7章的《API URL 所支持的快递公司及参数说明》 。如果找不到您所需的公司，请发邮件至 kuaidi@kingdee 咨询（大小不敏感）nuString是要查询的快递单号，请勿带特殊符号，不支持中文（大小不敏感）valicodeString否查询快递的电话号码，目前只有佳吉物流需要这个参数，其他公司请忽略showString否返回类型。0：返回json字符串，1：返回xml对象，2：返回html对象，3：返回text文本。如果不填，默认返回json字符串mutiStirng是返回信息数量，1:返回多行完整的信息，0:只返回一行信息。不填默认返回多行orderStirng否排序。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的邮件。

7、附录

本文档下载地址：

下载地址