获取物流轨迹 - 百腾物流文档

请求参数

Header 参数

action

string

固定值：trace

可选

示例值:

trace

code

string

必需

客户编码;由百腾提供;

sign

string

必需

sign=MD5(body+key);key为固定值:由百腾提供, 32位MD5;

Body 参数application/json

Data

string

百腾运单号

必需

示例

{
   "Data":"1111"
}

示例代码

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

curl --location --request POST '' \
--header 'action: trace' \
--header 'code;' \
--header 'sign;' \
--header 'Content-Type: application/json' \
--data-raw '{
   "Data":"1111"
}'

返回响应

🟢200成功

application/json

Body

Status

integer

必需

200:成功 600:数据错误 700:签名无效其他代码:Message携带错误信息

Message

string

必需

请求失败时的错误信息, 请求成功时为空

Data

array [object {3}]

TMS单号

必需

OccurDateTime

string

日期时间

必需

Event

string

路由状态

必需

Description

string

路由详情

必需

示例

{
    "Status": 200,
    "Message": "",
    "Data": [
        {
            "OccurDateTime": "2023-12-16 15:30:59",
            "Event": "已签收",
            "Description": "已签收,签收人:ABC,签收时间:2023-12-16 15:30,感谢使用百腾物流，期待再次为您服务"
        },
        {
            "OccurDateTime": "2023-12-16 15:29:29",
            "Event": "派送中",
            "Description": "准备派送中,派送员:【ewqe】,联系方式:【156****5864】"
        },
        {
            "OccurDateTime": "2023-12-16 15:28:53",
            "Event": "目的站到达",
            "Description": "已入库【青岛转运场】,扫描方式【人工扫描】,扫描人:【张三】;"
        },
        {
            "OccurDateTime": "2023-12-16 15:25:26",
            "Event": "运输中",
            "Description": "已离开【深圳转运中心(出港)】,前往【青岛转运场】"
        },
        {
            "OccurDateTime": "2023-12-16 15:24:49",
            "Event": "运输中",
            "Description": "已扫描出库，计划发往【青岛转运场】，扫描人:【李四】"
        },
        {
            "OccurDateTime": "2023-12-16 15:23:30",
            "Event": "运输中",
            "Description": "已入库【深圳转运中心(出港)】,扫描方式【人工扫描】,扫描人:【李四】;"
        },
        {
            "OccurDateTime": "2023-12-16 15:21:26",
            "Event": "运输中",
            "Description": "已扫描出库，计划发往【深圳转运中心(出港)】,扫描人:【王五】"
        },
        {
            "OccurDateTime": "2023-12-16 15:18:34",
            "Event": "已揽收",
            "Description": "【深圳项目操作组】制单完成,制单人:【王五】,制单方式:APP;"
        },
        {
            "OccurDateTime": "2023-12-16 14:58:51",
            "Event": "客户下单",
            "Description": "下单成功,货好时间:2023-12-17 00:00,下单方式:接口订单;"
        }
    ]
}