批量运单订阅接口 - Trackingeyes-API

1.每次订阅数量限制30条。
2.extendNo 扩展字段为厦门航空、京东航空专属必传字段，其余航司若赋值为无效信息。
3.不同的场景有不同的订阅方式，请参照下列👇订阅说明。

不同场景接口订阅类型说明

场景	订阅类型	参数说明	备注
正常订阅	订阅空运单号	referenceNo=空运单号 carrierCd=""(航司二字码/""=自动识别)	carrierCd可为空值，云当根据单号前三位自动识别
厦门航空	订阅空运单号+始发地+目的地	referenceNo=空运单号 carrierCd=""(航司二字码/""=自动识别) extendNo={"org": "始发地","dest": "目的地"}	该场景扩展字段必须按照格式上传org和dest参数，代码参照<空运支持清单>中厦航地点代码
京东航空新增 (需额外开通服务)	订阅空运单号+航班号+预计时间	referenceNo=空运单号 carrierCd=""(航司二字码/""=自动识别) extendNo={"flightNo": "航班号","pEtd": "航班预计出发日期"} serviceType=AF（默认AF）	该场景**扩展字段必须按照格式上传flightNo航班号和pEtd航班预计出发日期，日期格式：yyyy-mm-dd。仅提供预计和实际的抵离信息，其他动态信息无法提供
通过航班动态数据补充抵离动态新增 (需额外开通服务)	订阅综合接口数据 (空运+航班动态)	referenceNo=空运单号 carrierCd=""(航司二字码/""=自动识别) serviceType=AF（需明确该运单是否需要补充航班动态）	综合接口不支持只订阅航班动态数据，如仅需航班动态请使用航班动态数据接口

Request

Query Params

Body Params application/json

Example

[
    {
        "deliveryNo": "",
        "orderNo": "",
        "localKey": "",
        "referenceNo": "17203718536",
        "carrierCd": "CV",
        "extendNo": "",
        "customer": "",
        "customerService": "",
        "remark": ""
    },
    {
        "deliveryNo": "",
        "orderNo": "",
        "localKey": "",
        "referenceNo": "731-98211002",
        "carrierCd": "",
        "extendNo": {
            "org": "XMN",
            "dest": "BKK"
        },
        "customer": "",
        "customerService": "",
        "remark": ""
    },
    {
        "deliveryNo": "",
        "orderNo": "",
        "localKey": "",
        "referenceNo": "619-09858912",
        "carrierCd": "JG",
        "extendNo": {
            "flightNo": "8B861",
            "pEtd": "2026-09-10"
        },
        "customer": "",
        "customerService": "",
        "remark": "",
        "serviceType": "AF"
    }
]

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Responses

🟢200成功

application/json

Bodyapplication/json

Example

{
    "code": 200,
    "codeDesc": "success",
    "message": "Operation succeeded",
    "result": [
        {
            "deliveryNo": "",
            "orderNo": "",
            "referenceNo": "17203718536",
            "carrierCd": "CV",
            "serviceType": "A",
            "extendNo": "",
            "customer": "",
            "customerService": "",
            "remark": "",
            "billCreateTime": "2025-02-20 16:49:05",
            "id": "1892496683351281664",
            "localKey": "",
            "itemCode": 200,
            "itemCodeDesc": "success",
            "itemMessage": ""
        },
        {
            "deliveryNo": "",
            "orderNo": "",
            "referenceNo": "731-98211002",
            "carrierCd": "MF",
            "serviceType": "A",
            "extendNo": {
                "org": "XMN",
                "dest": "BKK"
            },
            "customer": "",
            "customerService": "",
            "remark": "",
            "billCreateTime": "2025-02-20 16:49:05",
            "id": "1892496683351282952",
            "localKey": "",
            "itemCode": 200,
            "itemCodeDesc": "success",
            "itemMessage": ""
        },
        {
            "deliveryNo": "",
            "orderNo": "",
            "referenceNo": "619-09858912",
            "carrierCd": "JG",
            "serviceType": "AF",
            "extendNo": {
                "flightNo": "8B861",
                "pEtd": "2026-09-10"
            },
            "customer": "",
            "customerService": "",
            "remark": "",
            "billCreateTime": "2026-09-09 15:03:01",
            "id": "2097581523867275264",
            "localKey": "",
            "itemCode": 200,
            "itemCodeDesc": "success",
            "itemMessage": ""
        }
    ]
}