即时查询(轨迹地图版)

1.即时查询(轨迹地图版)接口
（1）查询接口支持按照运单号查询(单个查询)。
（2）接口需要指定快递单号的快递公司编码，格式不对或则编码错误都会返失败的信息。
如：EMS物流单号应选择快递公司编码（EMS）查看快递公司编码
（3）返回的物流跟踪信息按照发生的时间升序排列。
（4）接口指令8003。
（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 'https://api.kdniao.com/Ebusiness/EbusinessOrderHandle.aspx' \ --header 'Content-Type: application/json' \ --data-raw '{ "IsReturnCoordinates":1, "OrderCode":"", "ShipperCode":"YTO", "LogisticCode":"YT9259962006185", "SenderCityName":"泉州市", "ReceiverCityName":"亳州市" }'

{ "ReceiverCityLatAndLng": "33.8764100,115.7791400", "LogisticCode": "YT9259962006184", "ShipperCode": "YTO", "Traces": [], "State": "0", "SenderCityLatAndLng": "24.8894600,118.6130000", "EBusinessID": "1305585", "Reason": "暂无轨迹信息", "Success": true }

请求参数

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

快递公司编码

必需

IsReturnCoordinates

integer

必需

是否返回城市经纬度 1 返回 2 不返回默认1

IsReturnRouteMap

integer

必需

是否返回轨迹地图 1 返回 2 不返回默认1

LogisticCode

string

物流单号

必需

SenderCityName

string

发件城市

必需

ReceiverCityName

string

收件城市

必需

示例

返回响应

🟢200成功

application/json

Body

StateEx

string

必需

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

EstimatedDeliveryTime

string

预计到达时间

必需

PreCoordinates

array [object {2}]

必需

LatAndLng

string

必需

Location

string

必需

ShipperCode

string

快递公司编码

必需

Traces

array [object {4}]

必需

Action

string

当前状态

必需

AcceptStation

string

描述

必需

AcceptTime

string

时间

必需

Location

string

当前城市

必需

Coordinates

array [object {2}]

必需

LatAndLng

string

经纬度

必需

Location

string

城市

必需

EBusinessID

string

用户ID

必需

Success

boolean

成功与否

必需

ReceiverCityLatAndLng

string

收件城市经纬度

必需

LogisticCode

string

物流运单号

必需

State

string

必需

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

SenderCityLatAndLng

string

发件城市经纬度

必需

Location

string

增值所在城市

必需

RouteMapUrl

string

轨迹地图URL

必需