批量运单订阅接口 - 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/2/20 16:49:05",
      "id": "1892496683351281664",
      "localKey": "",
      "itemCode": 200,
      "itemCodeDesc": "success",
      "itemMessage": ""
    }
  ]
}