api.yicha138.com 获得物流单号的跟踪信息(免费)

分享到:

通过向指定的地址发送请求,即可返回如JSON、XML等格式的跟综结果

1、应用场景
(1)电商网站用户打开“我的订单”时调用此API显示结果
(2)物流系统对帐前调用此API查一次所有运单的签收状态
2、是否需要授权
是,请到 快递查询API申请地址 申请
3、请求地址
http://api.yicha138.com/api?id=[]&com=[]&nu=[]&valicode=[]&show=[0|1|2|3]&muti=[0|1]&order=[desc|asc]

4.输入参数

名称 类型 是否必需   描述
id String 身份授权key,请 快递查询接口 进行申请(大小写敏感)
com String 要查询的快递公司代码,不支持中文,对应的公司代码见
API URL 所支持的快递公司及参数说明》。
如果找不到您所需的公司,请发邮件至 kuaidi@yicha138.com 咨询(大小写不敏感)
nu String 要查询的快递单号,请勿带特殊符号,不支持中文(大小写不敏感)
valicode String 已弃用字段,无意义,请忽略。
show String 返回类型:
0:返回json字符串,
1:返回xml对象,
2:返回html对象,
3:返回text文本。
如果不填,默认返回json字符串。
muti String 返回信息数量:
1:返回多行完整的信息,
0:只返回一行信息。
不填默认返回多行。
order String 排序:
desc:按时间由新到旧排列,
asc:按时间由旧到新排列。
不填默认返回倒序(大小写不敏感)

5.返回结果

字段名称   字段含义
com 物流公司编号
nu 物流单号
time 每条跟踪信息的时间
context 每条跟综信息的描述
state 快递单当前的状态 : 
0:在途中,
1:已发货,
2:疑难件,
3:已签收,
4:已退货。
该状态还在不断完善中,若您有更多的参数需求,欢迎发邮件至 kuaidi@yicha138.com 提出。
status 查询结果状态:
0:物流单暂无结果,
1:查询成功,
2:接口出现异常,
message 无意义,请忽略
condition 无意义,请忽略
ischeck 无意义,请忽略

6.返回示例

XML格式
<xml>
<message>ok</message>
<nu>1200722815552</nu>
<ischeck>1</ischeck>
<com>yunda</com>
<status>1</status>
<condition>F00</condition>
<data>
<time>2013-03-03 19:24:48</time>
<context>江苏泗阳县公司:进行揽件扫描</context>
</data>
<data>
<time>2013-03-03 19:25:10</time>
<context>江苏泗阳县公司:进行发出扫描,将发往:江苏淮安中转站</context>
</data>
<data>
<time>2013-03-03 21:44:47</time>
<context>江苏淮安中转站:快件进入分拨中心进行分拨</context>
</data>
<data>
<time>2013-03-04 03:22:44</time>
<context>江苏南京中转站:从站点发出,本次转运目的地:江苏南京栖霞区仙林公司</context>
</data>
<data>
<time>2013-03-04 08:25:03</time>
<context>江苏南京栖霞区仙林公司:到达目的地网点,快件将很快进行派送</context>
</data>
<data>
<time>2013-03-04 13:09:58</time>
<context>江苏南京栖霞区仙林公司:进行派件扫描;派送业务员:孙;(</context>
</data>
<data>
<time>2013-03-04 13:19:47</time>
<context>江苏南京栖霞区仙林公司:快件已被 图片 签收</context>
</data>
<state>3</state>
</xml>

7. API工具

>> 易查138查询范例ASP版(38.2KB) 下载
>> 易查138查询范例PHP版(43.7KB) 下载
>> 易查138查询范例.NET版(38.6KB) 下载
>> 易查138查询范例JAVA版(8.40KB) 下载
>> Shopex、Ecshop、Hishop和最土团购等快递查询插件 下载

8.FAQ