批量及时请求接口 - Trackingeyes数据接口

请求参数

Query 参数

companyCode

string

必需

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

token

string

必需

获取token接口返回的记录

orgCode

string

组织代码

可选

Body 参数application/json

type

string

更新类型

可选

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

batchId

string

批次号

可选

<= 64 字符

data

array [object {5}]

必需

localKey

string

客户本地关键字

可选

唯一值

<= 38 字符

referenceNo

string

订阅号

必需

<= 32 字符

carrierCd

string

云当船东代码

必需

船东代码参照海运支持清单中云当代码

<= 16 字符

extendNo

string

扩展数据对象

可选

提单号订阅SINO，该字段必须多传一个箱号才能订阅成功，例如：{"ctnrNo":"BHCU4987386"}

blType

string

订阅类型

可选

BL=提单号/BK=订舱号/CN=箱号，空值=自动识别

<= 32 字符

示例

{
    "type": "SR",
    "batchId": "123456789",
    "data": [
        {
            "localKey": null,
            "referenceNo": "SNLFSHJL32E3569",
            "carrierCd": "SINO",
            "blType": "BL",
            "extendNo": {
                "ctnrNo": "SNBU2285642"
            }
        },
        {
            "localKey": "A123456",
            "referenceNo": "CXDU1599297",
            "carrierCd": "ONE",
            "blType": "CN",
            "extendNo": null
        }
    ]
}

示例代码

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/timelyUpdate?companyCode&token&orgCode' \
--header 'Content-Type: application/json' \
--data-raw '{
    "type": "SR",
    "batchId": "123456789",
    "data": [
        {
            "localKey": null,
            "referenceNo": "SNLFSHJL32E3569",
            "carrierCd": "SINO",
            "blType": "BL",
            "extendNo": {
                "ctnrNo": "SNBU2285642"
            }
        },
        {
            "localKey": "A123456",
            "referenceNo": "CXDU1599297",
            "carrierCd": "ONE",
            "blType": "CN",
            "extendNo": null
        }
    ]
}'

返回响应

🟢200成功

application/json

Body

code

integer

状态码

必需

200=成功，其他=失败

codeDesc

string

状态描述

可选

<= 8 字符

message

string

错误信息

可选

<= 255 字符

result

array [object {9}]

返回结果

可选

batchId

string

批次号

可选

<= 64 字符

requestId

string

请求号（请求单票关键字）

可选

<= 64 字符

localKey

string

客户本地关键字

可选

唯一值

<= 38 字符

referenceNo

string

订阅号

可选

<= 32 字符

carrierCd

string

云当船东代码

可选

船东代码参照海运支持清单中云当代码

<= 16 字符

blType

string

订阅类型

可选

BL=提单号/BK=订舱号/CN=箱号，空值=自动识别

<= 32 字符

stateCode

string

单票请求状态

必需

S=成功，F=失败

<= 12 字符

message

string

失败原因

可选

callTime

string <date-time>

请求时间

可选

示例

{
    "code": 200,
    "codeDesc": "success",
    "message": "Operation succeeded",
    "result": [
        {
            "batchId": "123456789",
            "requestId": "20250507143000",
            "localKey": null,
            "referenceNo": "SNLFSHJL32E3569",
            "carrierCd": "BLNO",
            "blType": "BL",
            "stateCode": "S",
            "message": null,
            "callTime": "2025-05-09 18:00:00"
        },
        {
            "batchId": "123456789",
            "requestId": "20250507143001",
            "localKey": "A123456",
            "referenceNo": "CXDU1599297",
            "carrierCd": "ONE",
            "blType": "CN",
            "stateCode": "S",
            "message": null,
            "callTime": "2025-05-09 18:00:00"
        }
    ]
}