批量运单订阅接口 - Trackingeyes数据接口

请求参数

Query 参数

companyCode

string

必需

公司编码（需向云当网申请）

orgCode

string

组织编码

可选

token

string

必需

获取token接口返回的token值

Body 参数application/json

array of:

deliveryNo

string

交货单号

可选

<= 38 字符

orderNo

string

需货单号

可选

<= 600 字符

localKey

string

本地关键字

可选

贵司自定义的主键

<= 38 字符

referenceNo

string

订阅号

必需

空运单号

<= 32 字符

carrierCd

string

航司

可选

航司二字码。若空值，云当根据单号前三位自动匹配

<= 16 字符

extendNo

string

扩展数据Json

可选

长度不定

customer

string

客户

可选

<= 128 字符

customerService

string

商服姓名

可选

<= 128 字符

remark

string

备注

可选

<= 255 字符

示例

[
    {
        "deliveryNo": "",
        "orderNo": "",
        "localKey": "",
        "referenceNo": "23591210755",
        "carrierCd": "TK",
        "extendNo": "",
        "customer": "",
        "customerService": "",
        "remark":""
    }
]

示例代码

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/airLinesBill/bookAirLines?companyCode&orgCode&token' \
--header 'Content-Type: application/json' \
--data-raw '[
    {
        "deliveryNo": "",
        "orderNo": "",
        "localKey": "",
        "referenceNo": "23591210755",
        "carrierCd": "TK",
        "extendNo": "",
        "customer": "",
        "customerService": "",
        "remark":""
    }
]'

返回响应

🟢200成功

application/json

Body

code

integer

批量订阅状态代码

必需

200=全部订阅成功，300=警告（部分失败），400=全部订阅失败，500=异常

codeDesc

string

批量订阅状态描述

必需

success=全部订阅成功, warning=警告(结果中有itemCodeDesc=warning或者failure)，failure=全部订阅失败

<= 255 字符

message

string

异常信息

必需

<= 255 字符

result

array [object {14}]

结果集（单票订阅详情）

必需

deliveryNo

string

交货单号

可选

<= 38 字符

orderNo

string

需货单号

可选

<= 600 字符

referenceNo

string

主单号

可选

<= 32 字符

carrierCd

string

航司

可选

<= 16 字符

extendNo

string

扩展数据Json

可选

长度不定

customer

string

客户

可选

<= 128 字符

customerService

string

商服姓名

可选

<= 128 字符

remark

string

备注

可选

<= 255 字符

billCreateTime

string <date-time>

运单创建时间

可选

id

string

运单id

可选

订阅成功后返回的唯一值

<= 32 字符

localKey

string

本地关键字

可选

<= 38 字符

itemCode

integer

单票订阅状态

可选

200=成功，300=警告（重复订阅等），400=失败

itemCodeDesc

string

单票订阅状态说明

可选

success=订阅成功, warning=警告(重复订阅等)，failure=订阅失败

<= 8 字符

itemMessage

string

补充说明

可选

订阅失败的原因等

<= 255 字符

示例

{
    "code": 200,
    "codeDesc": "success",
    "message": "Operation succeeded",
    "result": [
        {
            "deliveryNo": "",
            "orderNo": "",
            "referenceNo": "23591210755",
            "carrierCd": "TK",
            "extendNo": "",
            "customer": "",
            "customerService": "",
            "remark": "",
            "billCreateTime": "2025-02-20 16:49:05",
            "id": "1892496683351281664",
            "localKey": "",
            "itemCode": 200,
            "itemCodeDesc": "success",
            "itemMessage": ""
        }
    ]
}