轨迹查询

接口

tracking

method

POST

Header

参数 是否必填 说明
Content-Type 必填 application/json;charset=UTF-8
x-lt-openKeyId 必填 访问用户隐私数据时的唯一权限标识 openKeyId
x-lt-timestamp 必填 请求时间戳，格式为时间转换为毫秒的值，也就是从1970年1月1日起至今的时间转换为毫秒，如：1583398764000
x-lt-signature 必填 接口签名 签名规则

请求示例

  • BODY
{
    "trackingNumbers": [
        "WP2407260014376",
        "WP2407260001447"
    ]
}

请求参数：

参数 类型 是否必填 说明
trackingNumbers list 是 多个跟踪号
rtiFlag String 否 是否返回包裹目的地信息（Return to Information of recipient）默认为false

响应示例

参数 类型 说明
code int 响应码
success boolean true：成功，false:失败
data object 响应数据
msg String 响应说明
  • data 说明
参数 类型 说明
trackingNumber string 跟踪号
channelCode string 渠道
shipFromCountry string 发件地址国家
shipToCountry string 收件地址国家
trackingStatus string 轨迹状态
trackingEventHistory list 跟踪号轨迹事件
packageDestinationLocation Object 包裹目的地
  • trackingEventHistory 说明
参数 类型 说明
eventCode string 跟踪状态
eventDesc string 跟踪描述
eventLocation string 跟踪发生地点
eventTime string 跟踪发生时间
eventZone string 跟踪发生时间时区
  • packageDestinationLocation 说明
参数 类型 说明
countryCode string 国家
state string 省州
city string 城市
postcode string 邮编
address1 string 地址1
address2 string 地址2
doorplate string 门牌号
  • eventCode 说明
参数 类型 中文说明 英文文说明
SI string 快递信息发送 Shipment Information sent to the Carrier
WP string 等待取件 Waiting for Pickup
DP string 派送员已派遣 Driver Dispatched for Pickup
PU string 已取件 Shipment Picked Up by Carrier
IT string 运输中 In Transit
AT string 到达转运点 Arrived at WP location+网点
AP string 到达配送点 Arrived at Final Destination and Is Being Processed
AC string 到达承运商终端 Arrived at Carrier Terminal
AS string 预约已安排 Appointment Scheduled
OD string 派送中 Out for Delivery
DD string 已送达 Delivered
DS string 退回寄件人，退件已签收 Delivered, returned to sender
DR string 派送失败，退回派送网点 Delivery failed, returned to delivery point
SE string 派送异常 Delivery exception
CS string 订单取消 Shipment cancelled by sender

成功示例

{
    "code": 200,
    "success": true,
    "msg": "轨迹查询成功",
    "data": [
        {
            "trackingNumber": "WP2407260014376",
            "channelCode": "WP_GROUND",
            "shipFromCountry": "US",
            "shipToCountry": "US",
            "trackingStatus": "SI",
            "trackingEventHistory": [
                {
                    "eventCode": "SI",
                    "eventDesc": "Shipment Information Sent to Western Post",
                    "eventLocation": "",
                    "eventTime": "2024-07-25 21:10:22",
                    "eventZone": "America/Los_Angeles"
                }
            ]
        },
        {
            "trackingNumber": "WP2407260001447",
            "channelCode": "WP_GROUND",
            "shipFromCountry": "US",
            "shipToCountry": "US",
            "trackingStatus": "SI",
            "trackingEventHistory": [
                {
                    "eventCode": "WP",
                    "eventDesc": "Waiting for Pickup",
                    "eventLocation": "",
                    "eventTime": "2024-07-25 19:50:22",
                    "eventZone": "America/Los_Angeles"
                },
                {
                    "eventCode": "SI",
                    "eventDesc": "Shipment Information Sent to Western Post",
                    "eventLocation": "",
                    "eventTime": "2024-07-25 19:21:22",
                    "eventZone": "America/Los_Angeles"
                }
            ]
        }
    ],
    "error": null
}

失败示例

{
    "code": 500,
    "success": false,
    "msg": "[trackingNumbers]must not be empty",
    "data": "",
    "error": "[trackingNumbers]must not be empty"
}

鉴权示例

{
    "code": 401,
    "success": false,
    "msg": "认证失败",
    "data": "",
    "error": "认证失败"
}
作者：陆飞  创建时间：2025-12-18 14:14
最后编辑：陆飞  更新时间：2026-03-03 10:08