Android 快递接口

名称	类型	是否必需	描述
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：已退货。该状态还在不断完善中，有更多的参数需求，欢迎发邮件至 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":"","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. 发邮件至 kuaidi@kingdee.com， 

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	中邮物流