名称 |
类型 |
是否必需 |
描述 |
id |
String |
是 |
身份授权Key,请到 http://www.kuaidi100.com/openapi 进行申请(大小敏感) |
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":"","data":[{"time":"2010-08-04 02:26","context":"由【杭州集散】发往【湖州中转站】"},{"time":"2010-07-12 01:48","context":"【东莞集散】的收件员【企石线】已收件"},{"time":"2010-07-01 11:19","context":"【泰州海陵】的派件员【刘魁15850876697】正在派件"},{"time":"2010-06-27 09:59","context":"快件已到达【缙云壶镇】 扫描员是【3161785】上一站是【金华分拨中心】"},{"time":"2010-06-27 09:45","context":"快件已到达【淮安分拨中心】 扫描员是【王怀标】上一站是【徐州】"},{"time":"2010-05-22 18:58","context":"由【浦东分拨中心】发往【上海】"},{"time":"2010-05-21 21:12","context":"快件已到达【杭州集散】 扫描员是【李淑梅】上一站是【无】"},{"time":"2010-04-25 21:45","context":"由【北京集散】发往【哈尔滨】"}],"status":1}
4.3 xml返回示例
<xml>
<message />
<data>
<time>2010-08-04 02:26</time>
<context>由【杭州集散】发往【湖州中转站】</context>
</data>
<data>
<time>2010-07-12 01:48</time>
<context>【东莞集散】的收件员【企石线】已收件</context>
</data>
<data>
<time>2010-07-01 11:19</time>
<context>【泰州海陵】的派件员【刘魁15850876697】正在派件</context>
</data>
<data>
<time>2010-06-27 09:59</time>
<context>快件已到达【缙云壶镇】 扫描员是【3161785】上一站是【金华分拨中心】</context>
</data>
<data>
<time>2010-06-27 09:45</time>
<context>快件已到达【淮安分拨中心】 扫描员是【王怀标】上一站是【徐州】</context>
</data>
<data>
<time>2010-05-22 18:58</time>
<context>由【浦东分拨中心】发往【上海】</context>
</data>
<data>
<time>2010-05-21 21:12</time>
<context>快件已到达【杭州集散】 扫描员是【李淑梅】上一站是【无】</context>
</data>
<data>
<time>2010-04-25 21:45</time>
<context>由【北京集散】发往【哈尔滨】</context>
</data>
<status>1</status>
</xml>
4.4 html返回示例
时间 |
地点和跟踪进度 |
2010-08-04 02:26 |
由【杭州集散】发往【湖州中转站】 |
2010-07-12 01:48 |
【东莞集散】的收件员【企石线】已收件 |
2010-07-01 11:19 |
【泰州海陵】的派件员【刘魁15850876697】正在派件 |
2010-06-27 09:59 |
快件已到达【缙云壶镇】 扫描员是【3161785】上一站是【金华分拨中心】 |
2010-06-27 09:45 |
快件已到达【淮安分拨中心】 扫描员是【王怀标】上一站是【徐州】 |
2010-05-22 18:58 |
由【浦东分拨中心】发往【上海】 |
2010-05-21 21:12 |
快件已到达【杭州集散】 扫描员是【李淑梅】上一站是【无】 |
2010-04-25 21:45 |
由【北京集散】发往【哈尔滨】 |
4.5 text返回示例
2010-08-04 02:26 由【杭州集散】发往【湖州中转站】
2010-07-12 01:48 【东莞集散】的收件员【企石线】已收件
2010-07-01 11:19 【泰州海陵】的派件员【刘魁15850876697】正在派件
2010-06-27 09:59 快件已到达【缙云壶镇】 扫描员是【3161785】上一站是【金华分拨中心】
2010-06-27 09:45 快件已到达【淮安分拨中心】 扫描员是【王怀标】上一站是【徐州】
2010-05-22 18:58 由【浦东分拨中心】发往【上海】
2010-05-21 21:12 快件已到达【杭州集散】 扫描员是【李淑梅】上一站是【无】
2010-04-25
5、开发案例及插件支持
· 目前提供ASP、ASP.NET、PHP和Java等四个版本的开发实例,请到http://www.kuaidi100.com/openapi/api_2_03.shtml下载。
· 插件支持:http://www.kuaidi100.com/openapi/api_6_02.shtml
6、FAQ及技术支持
· 常见问题FAQ:http://www.kuaidi100.com/help/qa.shtml
· 技术支持:
1. 发邮件至 [email protected],
2. 论坛,
3. QQ、电话等:见获得授权key的邮件。
7、附录
API URL 所支持的快递公司及参数说明
||'
分类 |
快递公司代码 |
公司名称 |
A |
|
|
|
aae |
AAE |
|
anxindakuaixi |
安信达 |
B |
|
|
|
baifudongfang |
百福东方 |
|
bht |
BHT |
|
youzhengguonei |
包裹/平邮/挂号信(暂不支持,请转用Open_API_APICode_URL) |
C |
|
|
|
cces |
希伊艾斯(CCES) |
|
coe |
中国东方(COE) |
D |
|
|
|
datianwuliu |
大田物流 |
|
debangwuliu |
德邦物流 |
|
dpex |
DPEX |
|
dhl |
DHL |
|
dsukuaidi |
D速快递 |
E |
|
|
|
ems |
EMS(暂不支持,请转用Open_API_APICode_URL) |
|
ems |
E邮宝(暂不支持,请转用Open_API_APICode_URL) |
F |
|
|
|
fedex |
Fedex(国际)(说明:Fedex是国际,国内的请用“lianbangkuaidi”) |
|
feikangda |
飞康达物流 |
|
feikuaida |
飞快达 |
|
rufengda |
凡客如风达 |
G |
|
|
|
ganzhongnengda |
港中能达 |
|
guangdongyouzhengwuliu |
广东邮政 |
|
youzhengguonei |
挂号信(暂不支持,请转用Open_API_APICode_URL) |
|
youzhengguonei |
国内邮件(暂不支持,请转用Open_API_APICode_URL) |
|
youzhengguoji |
国际邮件(暂不支持,请转用Open_API_APICode_URL) |
|
gls |
GLS |
H |
|
|
|
huitongkuaidi |
汇通快运 |
|
hengluwuliu |
恒路物流 |
|
huaxialongwuliu |
华夏龙 |
|
tiantian |
海航天天 |
|
haiwaihuanqiu |
海外环球 |
J |
|
|
|
jinguangsudikuaijian |
京广速递 |
|
jixianda |
急先达 |
|
jiajiwuliu |
佳吉物流 |
|
jiayiwuliu |
佳怡物流 |
|
jiayunmeiwuliu |
加运美 |
|
jinyuekuaidi |
晋越快递 |
K |
|
|
|
kuaijiesudi |
快捷速递 |
L |
|
|
|
lianhaowuliu |
联昊通 |
|
longbanwuliu |
龙邦物流 |
|
lanbiaokuaidi |
蓝镖快递 |
|
lejiedi |
乐捷递(暂不支持) |
|
lianbangkuaidi |
联邦快递(国内)(说明:国外的请用 fedex) |
M |
|
|
|
minghangkuaidi |
民航快递 |
R |
|
|
|
rufengda |
如风达快递 |
Q |
|
|
|
quanchenkuaidi |
全晨快递 |
|
quanjitong |
全际通 |
|
quanritongkuaidi |
全日通 |
|
quanyikuaidi |
全一快递 |
|
quanfengkuaidi |
全峰快递 |
S |
|
|
|
shentong |
申通速递(暂不支持,请转用Open_API_Chaxun_URL) |
|
shentong |
申通E物流(暂不支持,请转用Open_API_Chaxun_URL) |
|
shunfeng |
顺丰速递(暂不支持,请转用Open_API_APICode_URL) |
|
santaisudi |
三态速递 |
|
shenghuiwuliu |
盛辉物流 |
|
suer |
速尔物流 |
|
shengfengwuliu |
盛丰物流 |
|
shangda |
上大物流 |
|
santaisudi |
三态速递 |
|
shandonghaihong |
山东海红 |
|
saiodi |
赛澳递 |
T |
|
|
|
tiandihuayu |
天地华宇 |
|
tiantian |
天天快递 |
|
tnt |
TNT |
U |
|
|
|
ups |
UPS |
W |
|
|
|
wanjiawuliu |
万家物流 |
|
wxwl |
万象物流(即将支持) |
X |
|
|
|
xinbangwuliu |
新邦物流 |
|
xinfengwuliu |
信丰物流 |
|
xingchengjibian |
星晨急便(暂不支持,请转用Open_API_APICode_URL) |
|
xinhongyukuaidi |
鑫飞鸿 |
Y |
|
|
|
yafengsudi |
亚风速递 |
|
yibangwuliu |
一邦速递 |
|
youshuwuliu |
优速物流 |
|
yuanchengwuliu |
远成物流 |
|
yuantong |
圆通速递 |
|
yuanweifeng |
源伟丰快递 |
|
yuanzhijiecheng |
元智捷诚 |
|
yuefengwuliu |
越丰物流 |
|
yunda |
韵达快运 |
|
yuananda |
源安达 |
|
yuanfeihangwuliu |
原飞航 |
|
yuntongkuaidi |
运通快递 |
|
zhongxinda |
忠信达快递 |
|
zhimakaimen |
芝麻开门 |
|
youzhengguonei |
邮政国内给据(暂不支持,请转用Open_API_APICode_URL) |
|
youzhengguoji |
邮政国际(暂不支持,请转用Open_API_APICode_URL) |
Z |
|
|
|
zhaijisong |
宅急送 |
|
zhongtiewuliu |
中铁快运 |
|
zhongtong |
中通速递 |
|
zhongyouwuliu |
中邮物流 |