查询轨迹 - 腾信国际客户API对接文档

请求参数

Header 参数

apiAccount

string

必需

API KEY，可在OMS后台进行申请或联系业务员申请

timestamp

string

必需

当前 UNIX 时间戳，可记录发起 API 请求的时间。例如 1681766460。注意：如果与服务器时间相差超过5分钟，会引起签名过期错误

sign

string

必需

签名：apiAccount+ apiPasswd+ timestamp三个参数进行拼接，然后MD5加密获取MD5值

Body 参数application/json

billNo

string

运单号/客户单号

必需

示例

{
    "billNo":"ICBU000000000197"
}

示例代码

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

curl --location --request POST '/openApi/erp/getOrderTrackInfo' \
--header 'apiAccount;' \
--header 'timestamp;' \
--header 'sign;' \
--header 'Content-Type: application/json' \
--data-raw '{
    "billNo":"ICBU000000000197"
}'

返回响应

🟢200成功

application/json

Body

code

integer

响应码

必需

message

string

响应消息

必需

data

array [object {2}]

响应结果集

必需

billNoSub

string

子单号

必需

trackList

array [object {5}]

轨迹集合

必需

total

integer

总条数

必需

示例

成功示例异常示例

{"code":200,"message":"成功","data":[{"billNoSub":"ICBU00000000019700001","trackList":[{"billNoSub":"ICBU00000000019700001","trackNo":"QG_CYDJ","trackInfo":"查验登记","trackInfoEn":"fffffffffff","trackPosition":null,"trackTime":"2024-09-11 16:46:46"},{"billNoSub":"ICBU00000000019700001","trackNo":"ZD00102","trackInfo":"订舱分配","trackInfoEn":"sss","trackPosition":"深圳","trackTime":"2024-09-14 09:32:43"}]},{"billNoSub":"ICBU00000000019700003","trackList":[{"billNoSub":"ICBU00000000019700003","trackNo":"QG_CYDJ","trackInfo":"查验登记","trackInfoEn":"fffffffffff","trackPosition":null,"trackTime":"2024-09-11 16:46:46"},{"billNoSub":"ICBU00000000019700003","trackNo":"ZD00102","trackInfo":"订舱分配","trackInfoEn":"sss","trackPosition":"深圳","trackTime":"2024-09-14 09:32:43"}]},{"billNoSub":"ICBU00000000019700002","trackList":[{"billNoSub":"ICBU00000000019700002","trackNo":"QG_CYDJ","trackInfo":"查验登记","trackInfoEn":"fffffffffff","trackPosition":null,"trackTime":"2024-09-11 16:46:46"},{"billNoSub":"ICBU00000000019700002","trackNo":"ZD00102","trackInfo":"订舱分配","trackInfoEn":"sss","trackPosition":"深圳","trackTime":"2024-09-14 09:32:43"}]},{"billNoSub":"ICBU00000000019700005","trackList":[{"billNoSub":"ICBU00000000019700005","trackNo":"QG_CYDJ","trackInfo":"查验登记","trackInfoEn":"fffffffffff","trackPosition":null,"trackTime":"2024-09-11 16:46:46"},{"billNoSub":"ICBU00000000019700005","trackNo":"ZD00102","trackInfo":"订舱分配","trackInfoEn":"sss","trackPosition":"深圳","trackTime":"2024-09-14 09:32:43"}]},{"billNoSub":"ICBU00000000019700004","trackList":[{"billNoSub":"ICBU00000000019700004","trackNo":"QG_CYDJ","trackInfo":"查验登记","trackInfoEn":"fffffffffff","trackPosition":null,"trackTime":"2024-09-11 16:46:46"},{"billNoSub":"ICBU00000000019700004","trackNo":"ZD00102","trackInfo":"订舱分配","trackInfoEn":"sss","trackPosition":"深圳","trackTime":"2024-09-14 09:32:43"}]}],"total":5}