即时查询(增值版)接口

（1）查询接口支持按照运单号查询(单个查询)。
（2）接口需要指定快递单号的快递公司编码，格式不对或则编码错误都会返失败的信息。
如：EMS物流单号应选择快递公司编码（EMS）查看快递公司编码
（3）返回的物流跟踪信息按照发生的时间升序排列。
（4）接口指令8001。
（5）接口支持的消息接收方式为HTTP POST，请求方法的编码格式(utf-8)："application/x-www-form-urlencoded;charset=utf-8"。
（6）接口地址： API测试地址：http://sandboxapi.kdniao.com:8080/kdniaosandbox/gateway/exterfaceInvoke.json
API正式地址：https://api.kdniao.com/Ebusiness/EbusinessOrderHandle.aspx

curl --location --request POST 'http://prod-cn.your-api-server.com/Ebusiness/EbusinessOrderHandle.aspx' \ --header 'Content-Type: application/json' \ --data-raw '{ "OrderCode": "", "ShipperCode": "QFKD", "LogisticCode": "390141793061" }'

请求参数

Body 参数application/json

RequestData

string

必需

请求内容需进行URL(utf-8)编码。请求内容JSON格式，须和DataType一致。

EBusinessID

string

必需

商户ID，请在我的服务页面查看。

RequestType

string

必需

请求指令类型：1007

DataSign

string

必需

数据内容签名：把(请求内容(未编码)+AppKey)进行MD5加密，然后Base64编码，最后进行URL(utf-8)编码。详细过程请查看Demo。

DataType

string

可选

请求、返回数据类型：只支持JSON格式

OrderCode

string

订单编号

可选

ShipperCode

string

快递公司编码

必需

LogisticCode

string

物流单号

必需

示例

返回响应

🟢200成功

application/json

Body

EBusinessID

string

用户ID

必需

OrderCode

string

订单编号

必需

ShipperCode

string

快递公司编码

必需

Success

boolean

成功与否

必需

LogisticCode

string

物流运单号

必需

Reason

string

失败原因

必需

State

string

必需

物流状态：2-在途中,3-签收,4-问题件

StateEx

string

必需

增值物流状态： 1-已揽收， 2-在途中， 201-到达派件城市， 202-派件中， 211-已放入快递柜或驿站， 3-已签收， 311-已取出快递柜或驿站， 4-问题件， 401-发货无信息， 402-超时未签收， 403-超时未更新， 404-拒收（退件）， 412-快递柜或驿站超时未取

Location

string

增值所在城市

必需

Traces

array [object {5}]

必需

AcceptTime

string

时间

必需

AcceptStation

string

描述

必需

Location

string

当前城市

必需

Action

string

当前状态

必需

Remark

string

备注

必需