Lingxing
切换旧版

获取追踪记录状态条数

POST/basicOpen/logistics/trackRecord/status/total

支持统计当前企业可访问店铺下各物流轨迹状态对应的记录数量。

接口信息

API Path请求协议请求方式令牌桶容量
/basicOpen/logistics/trackRecord/status/totalHTTPSPOST1

请求参数

本接口无需请求参数。

请求cURL示例

curl --location 'https://openapi.lingxing.com/basicOpen/logistics/trackRecord/status/total?access_token=value&timestamp=value&sign=value&app_key=value' \
--header 'Content-Type: application/json' \
--data '{}'

返回结果

Json Object

codeinteger必填
状态码,0:成功
示例 0
messagestring必填
消息提示
示例 success
error_detailsarray<any>必填
数据校验失败时的错误详情
request_idstring必填
请求链路id
示例 a0d54debf93140f3b58d1ed81e8e3583
response_timestring必填
响应时间
示例 2026-08-23 09:37:00
dataobject必填
响应数据
隐藏子属性
statusesarray<object>必填
状态统计列表
隐藏子属性
statusinteger必填
轨迹状态
1:暂无记录
2:等待揽收
3:运输途中
4:到达待取
5:签收成功
6:投递失败
7:物流异常
8:查询异常
示例 1
statusNamestring必填
轨迹状态名称
示例 暂无记录
totalinteger必填
状态对应的记录数
示例 12

返回成功示例

{
    "code": 0,
    "message": "success",
    "error_details": [],
    "request_id": "a0d54debf93140f3b58d1ed81e8e3583",
    "response_time": "2026-08-23 09:37:00",
    "data": {
        "statuses": [
            {
                "status": 1,
                "statusName": "暂无记录",
                "total": 12
            },
            {
                "status": 3,
                "statusName": "运输途中",
                "total": 35
            },
            {
                "status": 5,
                "statusName": "签收成功",
                "total": 48
            }
        ]
    }
}