5.tracking - YCS EXPRESS

服务能力：包裹物流轨迹追踪
请求地址：host:/tracking
请求方式：POST

Header 请求参数（用于token校验）:

参数名	示例值
token	4e411a926e7a33ca9d04cd1942ac54a2

Body 请求参数：

参数名	描述	是否必填	数据类型	字段长度
	运单号一次最多支持查询50单	是	Array	30

请求示例：

[
    "14232473333",
    "14232477430",
    "70000273865"
]

响应：

字段名	描述	数据类型
success	true 或者 false	Boolean
code	200：成功其他：失败	Integer
message	请求返回信息	String
requestId	请求ID	String
data		Array
waybill	运单号	String
referenceNo	参考号客户包裹号	String
latestStatus	最新状态	String
latestStatusTime	最新状态时间	String
events	轨迹节点详情	Array
location	轨迹发生地点	String
description	轨迹详情描述（本地文）	String
localTime	轨迹节点发生时间（本地时间）	String

成功返回示例：

{
    "success": true,
    "code": 200,
    "message": "success",
    "requestId": "66c19570e43d2479",
    "data": [
        {
            "waybill": "14232473333",
            "referenceNo": "TEST240109001",
            "latestStatus": "已完成取件",
            "latestStatusTime": "2024-01-16 08:19:00",
            "events": [
                {
                    "location": "全家大溪松樹店",
                    "description": "已完成取件",
                    "localTime": "2024-01-16 08:19:00"
                },
                {
                    "location": "全家大溪松樹店",
                    "description": "貨件配達取件店鋪，取件截止時間是2024-01-16",
                    "localTime": "2024-01-09 16:02:00"
                },
                {
                    "location": "",
                    "description": "貨件等待配送中",
                    "localTime": "2024-01-09 15:02:00"
                },
                {
                    "location": "",
                    "description": "貨件進行配送中",
                    "localTime": "2024-01-09 14:43:00"
                },
                {
                    "location": "",
                    "description": "貨件已完成理貨",
                    "localTime": "2024-01-09 11:38:00"
                },
                {
                    "location": "",
                    "description": "貨件抵達物流中心",
                    "localTime": "2024-01-09 11:27:00"
                },
                {
                    "location": "",
                    "description": "已創建包裹面單，派送單號是14232473333",
                    "localTime": "2024-01-09 10:11:38"
                },
                {
                    "location": "",
                    "description": "訂單成立",
                    "localTime": "2024-01-09 10:11:00"
                }
            ]
        },
        {
            "waybill": "14232477430",
            "referenceNo": "TEST240109002",
            "latestStatus": "貨件已退回賣家",
            "latestStatusTime": "2024-01-20 18:51:00",
            "events": [
                {
                    "location": "",
                    "description": "貨件已退回賣家",
                    "localTime": "2024-01-20 18:51:00"
                },
                {
                    "location": "",
                    "description": "貨件已退回物流中心",
                    "localTime": "2024-01-18 07:17:00"
                },
                {
                    "location": "",
                    "description": "未取退回物流中心",
                    "localTime": "2024-01-17 22:20:00"
                },
                {
                    "location": "全家大溪松樹店",
                    "description": "貨件配達取件店鋪，取件截止時間是2024-01-16",
                    "localTime": "2024-01-09 16:02:00"
                },
                {
                    "location": "",
                    "description": "貨件等待配送中",
                    "localTime": "2024-01-09 15:02:00"
                },
                {
                    "location": "",
                    "description": "貨件進行配送中",
                    "localTime": "2024-01-09 14:43:00"
                },
                {
                    "location": "",
                    "description": "貨件已完成理貨",
                    "localTime": "2024-01-09 11:38:00"
                },
                {
                    "location": "",
                    "description": "貨件抵達物流中心",
                    "localTime": "2024-01-09 11:27:00"
                },
                {
                    "location": "",
                    "description": "已創建包裹面單，派送單號是14232477430",
                    "localTime": "2024-01-09 10:31:36"
                },
                {
                    "location": "",
                    "description": "訂單成立",
                    "localTime": "2024-01-09 10:31:00"
                }
            ]
        },
        {
            "waybill": "70000273865",
            "referenceNo": "TEST190107003",
            "latestStatus": "已實名無需委任",
            "latestStatusTime": "2024-08-16 10:44:54",
            "events": [
                {
                    "location": "",
                    "description": "已實名無需委任",
                    "localTime": "2024-08-16 10:44:54"
                },
                {
                    "location": "",
                    "description": "已創建包裹面單，派送單號是70000273865",
                    "localTime": "2024-08-16 10:44:53"
                }
            ]
        }
    ]
}

错误代码说明：

错误代码	错误描述
1001	Token验证错误，请检查传入的Token是否正确
1002	请求参数数据结构错误，请检测后重新传入
1003	运单号超过50单
1004	接口异常

错误示例返回：

{
    "success":false,
    "code":1001,
    "message":"Token验证错误，请检查传入的Token是否正确",
    "requestId":"655c00af45b3a785"
}