Lingxing
切换旧版

获取追踪记录列表

POST/basicOpen/logistics/trackRecord/list

支持按时间、站点、店铺和物流商等条件查询物流轨迹追踪记录。

接口信息

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

请求参数

searchobject必填
查询条件
隐藏子属性
lengthinteger
分页长度，默认20，最大200
pageinteger
页码，默认1
dateFieldstring
日期筛选类型
shipped_at：发货时间
purchased_at：订购时间
endTimestring
结束时间，10位数字字符串形式的秒级时间戳
startTimestring
开始时间，10位数字字符串形式的秒级时间戳
receiveCountryCodesarray<any>
收件国家二字码（目的地）
platformCodesarray<any>
平台列表，传平台编码
siteCodesarray<any>
站点列表，格式为平台编码-站点编码
来源：查询订单管理订单列表 返回的 data>>list>>site_code
storeIdsarray<any>
店铺列表
logisticsProviderIdsarray<any>
物流商列表
logisticsTypeIdsarray<any>
物流方式列表
searchValuestring
查询单号
searchFieldstring
查询单号字段
platform_no：平台单号
order_no：系统单号
query_no：查询追踪号
seniorSearchListarray<object>
批量查询列表
隐藏子属性
searchFieldstring
查询单号字段
platform_no：平台单号
order_no：系统单号
query_no：查询追踪号
searchValuearray<any>
查询单号列表
sortFieldstring
排序字段
purchased_at：订购时间
shipped_at：发货时间
receipt_time：上网时间
delivered_time：妥投时间
sortTypestring
排序方式
desc：降序
asc：升序

请求cURL示例

curl --location 'https://openapi.lingxing.com/basicOpen/logistics/trackRecord/list?access_token=value&timestamp=value&sign=value&app_key=value' \
--header 'Content-Type: application/json' \
--data '{
    "search": {
        "length": 20,
        "page": 1,
        "dateField": "shipped_at",
        "startTime": "1746057600",
        "endTime": "1748736000",
        "receiveCountryCodes": ["US"],
        "platformCodes": ["10001"],
        "siteCodes": ["10011-US"],
        "storeIds": ["1234567890"],
        "logisticsProviderIds": ["1001"],
        "logisticsTypeIds": ["1001"],
        "searchField": "query_no",
        "searchValue": "9400111899223856928499",
        "seniorSearchList": [
            {
                "searchField": "query_no",
                "searchValue": ["9400111899223856928499"]
            }
        ],
        "sortField": "shipped_at",
        "sortType": "desc"
    }
}'

返回结果

Json Object

codeinteger必填
状态码，0：成功
示例 0
messagestring必填
消息提示
示例 success
error_detailsarray<any>必填
数据校验失败时的错误详情
request_idstring必填
请求链路id
示例 a0d54debf93140f3b58d1ed81e8e3583
response_timestring必填
响应时间
示例 2026-08-23 09:20:00
totalinteger必填
总数
示例 1
dataobject必填
响应数据
隐藏子属性
recordsarray<object>必填
追踪记录列表
隐藏子属性
recordIdinteger必填
追踪记录ID
示例 10001
orderNostring必填
源单号（系统单号）
示例 LX202505300001
orderTypestring必填
源单类型
示例 order
queryNostring必填
查询单号（查询追踪号）
示例 9400111899223856928499
logisticsProviderIdinteger必填
物流商编号
示例 1001
logisticsProviderNamestring必填
物流商名
示例 USPS
statusinteger必填
物流状态
示例 1
statusNamestring必填
物流状态名称
示例 运输中
deliveredDaysinteger必填
运输天数
示例 5
stayedDaysinteger必填
停留天数
示例 1
lastStayedAtinteger必填
最后停留时间戳（最新信息）
示例 1748563200
lastStayedDescriptionstring必填
最后停留状况描述（最新信息）
示例 Arrived at USPS Regional Facility
shippedAtinteger必填
发货时间戳
示例 1748217600
purchasedAtinteger必填
订购时间戳
示例 1748044800
sendCountryCodestring必填
发件国家二字码
示例 CN
receiveCountryCodestring必填
收件国家二字码
示例 US
trackSupplierCodeinteger必填
追踪服务商code
示例 1001
trackSupplierCarrierNamestring必填
查询承运商名称
示例 USPS
trackSupplierCarrierCodestring必填
查询承运商code
示例 USPS
storeIdinteger必填
店铺ID
示例 1234567890
storeNamestring必填
店铺名
示例 Amazon US Store
siteCodestring必填
站点code
示例 US
siteNamestring必填
站点名
示例 美国
platformCodestring必填
平台code
示例 amazon
buyerNamestring必填
买家姓名
示例 John Smith
platformNamestring必填
平台名称
示例 Amazon
deliveredTimestring
妥投时间，格式：yyyy-MM-dd HH:mm:ss
示例 2025-09-07 20:28:01
totalinteger必填
总数
示例 1

返回成功示例

{
    "code": 0,
    "message": "success",
    "error_details": [],
    "request_id": "a0d54debf93140f3b58d1ed81e8e3583",
    "response_time": "2026-08-23 09:20:00",
    "total": 1,
    "data": {
        "records": [
            {
                "recordId": 10001,
                "orderNo": "LX202505300001",
                "orderType": "order",
                "queryNo": "9400111899223856928499",
                "logisticsProviderId": 1001,
                "logisticsProviderName": "USPS",
                "status": 1,
                "statusName": "运输中",
                "deliveredDays": 5,
                "stayedDays": 1,
                "lastStayedAt": 1748563200,
                "lastStayedDescription": "Arrived at USPS Regional Facility",
                "shippedAt": 1748217600,
                "purchasedAt": 1748044800,
                "sendCountryCode": "CN",
                "receiveCountryCode": "US",
                "trackSupplierCode": 1001,
                "trackSupplierCarrierName": "USPS",
                "trackSupplierCarrierCode": "USPS",
                "storeId": 1234567890,
                "storeName": "Amazon US Store",
                "siteCode": "US",
                "siteName": "美国",
                "platformCode": "amazon",
                "buyerName": "John Smith",
                "platformName": "Amazon",
                "deliveredTime": "2025-09-07 20:28:01"
            }
        ],
        "total": 1
    }
}