批量及时更新接口 - Trackingeyes数据接口

请求参数

Query 参数

companyCode

string

必需

企业编号（需向云当网申请）

token

string

必需

获取token接口返回的记录

orgCode

string

组织代码

可选

Body 参数application/json

type

string

更新类型

可选

NR=普通请求，SR=加急请求，默认：NR

batchId

string

批次号

可选

<= 64 字符

data

array [object {1}]

必需

id

integer

订阅接口返回的运单关键字

可选

示例

{
    "type": "SR",
    "batchId": "123456789",
    "data": [
        {
            "id": 1915644277908705300
        },
        {
            "id": 1915299485228077000
        }
    ]
}

示例代码

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

curl --location --request POST 'https://api.trackingeyes.com/api/oceanbill/timelyUpdateById?companyCode&token&orgCode' \
--header 'Content-Type: application/json' \
--data-raw '{
    "type": "SR",
    "batchId": "123456789",
    "data": [
        {
            "id": 1915644277908705300
        },
        {
            "id": 1915299485228077000
        }
    ]
}'

返回响应

🟢200成功

application/json

Body

code

integer

状态码

必需

200=成功，其他=失败

codeDesc

string

状态描述

可选

<= 8 字符

message

string

错误信息

可选

<= 255 字符

result

array [object {6}]

可选

id

integer

订阅接口返回的运单关键字

可选

batchId

string

批次号

可选

<= 64 字符

requestId

string

请求号

可选

<= 64 字符

stateCode

string

单票请求状态

必需

S=成功，F=失败

<= 12 字符

message

string

失败原因

可选

callTime

string <date-time>

请求时间

可选

示例

{
    "code": 200,
    "codeDesc": "success",
    "message": "Operation succeeded",
    "result": [
        {
            "id": 1915644277908705300,
            "batchId": "123456789",
            "requestId": "20250507164300",
            "stateCode": "S",
            "message": null,
            "callTime": "2025-05-09 18:00:00"
        },
        {
            "id": 1915299485228077000,
            "batchId": "123456789",
            "requestId": "20250507164301",
            "stateCode": "S",
            "message": null,
            "callTime": "2025-05-09 18:00:00"
        }
    ]
}