快递物流查询接口介绍API接口

快递物流查询接口是指快递查询网对外开放的应用程序接口,开发人员能够通过调用该接口与快递查询网进行交互,并基于该接口开发自己的快递查询应用程序。目前比较常用的接口有快递鸟、菜鸟、快递100等。

1、应用场景

电商网站用户打开“我的订单”时调用此API显示物流信息详情;或者是电商管理后台的物流系统,客服在对账前查询所有运单的签收状态,并追踪问题。

快递物流查询接口介绍API接口_快递鸟

2、快递查询接口分类

物流轨迹查询接口有即时查询和订阅查询两种,即时是请求即返回数据,订阅则是订阅快递单号到接口,有物流轨迹更新则全量返回数据。 

快递物流查询接口介绍API接口_快递鸟

快递鸟即时接口可以查询3000次,3000以上接订阅接口,统一接口模式接入,常用快递均支持查询,还有订阅接口、在线下单接口、电子面单接口,接口均不收取费用,没有要求用户添加外链,支持1600家国内外快递物流查询公司。

快递100每天可以免费查询2000次,超过2000次收费,每次0.06~0.1元不等,如果查询的量大的话可以降低费用,免费的接口有几家常用快递不支持接口模式,只支持   htmlAPI,要求用户添加外链,支持300多家国内外快递物流查询。

快递网每天可以免费查询500次,超过500次收费,每次0.05元,只有即时查询和订阅推送接口,要求用户添加外链,支持395家国内外快递物流查询。

3、对接说明

不同公司的快递查询接口接入类似,都需要注册 ,申请账号获取KEY和ID,如果是订阅接口需要技术联调。以快递鸟及时查询接口接入为例。

根据快递单号和快递公司编码查询物流轨迹信息。接口需要指定快递单号的快递公司编码,格式不对或则编码错误都会返失败的信息。如:EMS物流单号应选择快递公司编码(EMS返回的物流跟踪信息按照发生的时间升序排列)。

快递查询接口类API技术文档地址:http://www.kdniao.com/api-all

5款热门产品:在途监控、快递查询、电子面单、轨迹地图、国际版在途监控“ 0元免费试用 ”活动地址:http://www.kdniao.com/v2/activity/try.aspx

接口支持的消息接收方式为HTTP POST

请求系统级参数

参数名称类型说明必须要求
RequestDataString请求内容需进行URL(utf-8)编码。请求内容JSON或XML格式,须和DataType一致。R
EBusinessIDString商户ID,请在我的服务页面查看。R
RequestTypeString请求指令类型:1002R
DataSignString数据内容签名:把(请求内容(未编码)+AppKey)进行MD5加密,然后Base64编码,最后进行URL(utf-8)编码。详细过程请查看Demo。R
DataTypeString请求、返回数据类型:1-xml,2-json;默认为xml格式O

请求内容字段定义

参数类型说明必须要求
OrderCodeString订单编号O
ShipperCodeString快递公司编码R
LogisticCodeString物流单号R

返回参数定义

参数名称类型说明必须要求
EBusinessIDString用户IDR
OrderCodeString订单编号O
ShipperCodeString快递公司编码R
LogisticCodeString物流运单号R
SuccessBool成功与否R
ReasonString失败原因O
StateString物流状态:2-在途中,3-签收,4-问题件R
Traces
TraceAcceptTimeString时间R
AcceptStationString描述R
RemarkString备注O