快递单号查询接口对接指南

快递查询接口API    

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

 

应用场景

 

 

 

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

 

快递查询接口分类

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

 

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

 

 

对接说明

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

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

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

        请求方法的编码格式(utf-8)："application/x-www-form-urlencoded;charset=utf-8"

        API地址：http://api.kdniao.cc/Ebusiness/EbusinessOrderHandle.aspx

 

 

请求系统级参数

 

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

 

 

 

请求内容字段定义

 

参数	类型	说明	必须要求
OrderCode	String	订单编号	O
ShipperCode	String	快递公司编码	R
LogisticCode	String	物流单号	R

 

返回参数定义

 

参数名称		类型	说明	必须要求
EBusinessID		String	用户ID	R
OrderCode		String	订单编号	O
ShipperCode		String	快递公司编码	R
LogisticCode		String	物流运单号	R
Success		Bool	成功与否	R
Reason		String	失败原因	O
State		String	物流状态：2-在途中,3-签收,4-问题件	R
Traces
Trace	AcceptTime	String	时间	R
	AcceptStation	String	描述	R
	Remark	String	备注	O

 

 

 

Java调用示例

 

import java.io.BufferedReader;
import java.io.IOException;
import java.io