Trackingeyes-API
🇨🇳 中文
  • 🇨🇳 中文
  • 🇺🇸 English
  1. 海运跟踪
Trackingeyes-API
🇨🇳 中文
  • 🇨🇳 中文
  • 🇺🇸 English
  • 操作指南
    • 主要接口
    • 获取密钥
    • 常见问题
  • 通用接口
    • 获取token
      POST
    • 获取港口支持代码
      GET
    • 获取船东支持代码
      GET
  • 海运数据接口
    • 海运数据
      • DEMO
      • 海运支持清单
      • 海运状态码
      • 海运跟踪
        • 批量运单订阅接口
          POST
        • 推送运单动态接口
          POST
        • 运单及时更新接口
          POST
        • 下载运单详情接口
          GET
      • 及时请求
        • 批量及时请求接口
        • 及时请求推送接口
    • 港区数据
      • 中国港区支持清单
      • 中国港区数据订阅接口
      • 中国港区数据推送接口
      • 中国港区数据下载接口
    • 集装箱轨迹
      • DEMO
      • 集装箱轨迹接口
    • 船舶计划
      • 口岸支持清单
      • 船舶计划查询接口
  • 船舶AIS接口
    • DEMO
    • 船舶轨迹
      • 单船搜索接口
      • 船舶定位接口
      • 船舶历史挂港接口
      • 船舶轨迹接口
    • 电子围栏
      • 电子围栏查询接口
  • AI船舶预测
    • DEMO
    • AI船舶挂港预测接口
      GET
  • 船期表接口
    • 港到港船期表
      • DEMO
      • 船期支持清单
      • 港到港船期查询接口
      • 船期分页推送接口
      • 港到港船期查询接口2.0
      • 港到港船期分页推送接口2.0
    • 航线表定路径
      • 航线表定路径接口
    • 航次挂靠路径
      • 航次挂靠路径支持清单
      • 航次挂靠路径查询接口
      • 船舶船期分页下载接口
  • 电商运价接口
    • DEMO
    • 船东电商运价
      • 运价支持清单
      • 运价查询接口
  • 空运数据接口
    • DEMO
    • 空运支持清单
    • 空运状态码
    • 空运跟踪
      • 批量运单订阅接口
      • 推送运单动态接口
      • 批量运单下载接口
  • 陆运数据接口
    • EIR(电子设备交接单)
      • EIR支持清单
      • EIR获取接口
    • 场站数据
      • 场站支持清单
      • 场站数据订阅接口
      • 场站数据推送接口
    • 车辆GPS
      • DEMO
      • 车辆定位接口
      • 车辆轨迹接口
      • 车辆路线规划接口
  • 关务数据接口
    • 报关状态
      • 报关状态代码表
      • 报关状态订阅接口
      • 报关状态推送接口
      • 下载报关状态接口
    • 舱单数据
      • 舱单数据订阅接口
      • 舱单数据推送接口
      • 下载舱单数据接口
  • 海外数据接口
    • 全球码头数据
      • 全球码头支持清单
      • 全球码头数据订阅接口
      • 全球码头数据推送接口
      • 全球码头数据下载接口
    • 美国清关状态
      • 清关状态代码
      • 清关海运支持清单
      • 美国清关数据查询接口
  • 快递数据接口
    • 国家、地区ISO Alpha-3代码表
    • 主状态代码表
    • 子状态代码表
    • 承运商代码表
    • 承运商集团表
    • 特殊承运人代码表
    • 快递数据订阅接口
    • 快递数据推送接口
    • 快递数据下载接口
  • 其他数据接口
    • 通用港杂费
      • 港杂费代码清单
      • 通用港杂费查询接口
    • 操作时间
      • 操作时间查询接口
  1. 海运跟踪

批量运单订阅接口

POST
https://api.trackingeyes.com/api/oceanbill/batchOceanBill
1.每次订阅数量限制30条。
2.code=warning说明部分失败,根据error错误代码判断原因。
3.若需重复订阅相同的单子,localKey参数需上传不同的值。
4.不同的场景有不同的订阅方式,请参照下列👇订阅说明。
不同场景接口订阅类型说明
image.png

Request

Query Params

Body Params application/json

Example
[
    {
        "deliveryNo": null,
        "orderNo": null,
        "localKey": "",
        "referenceNo": "177QAZAZXTCN0541",
        "blType": "BL",
        "carrierCd": "MSC",
        "extendNo": null,
        "customer": null,
        "polCd": null,
        "customerService": null,
        "noticeEmail": null,
        "remark": null,
        "serviceType": "C"
    },
    {
        "deliveryNo": null,
        "orderNo": null,
        "localKey": "",
        "referenceNo": "SNLFSKALB61601",
        "blType": "BL",
        "carrierCd": "SINO",
        "extendNo": {
            "CtnrNo": "BHCU4987386"
        },
        "customer": null,
        "polCd": null,
        "customerService": null,
        "noticeEmail": null,
        "remark": null,
        "serviceType": "C"
    },
    {
        "deliveryNo": null,
        "orderNo": null,
        "localKey": "",
        "referenceNo": "6414918850",
        "blType": "",
        "carrierCd": "COSCO",
        "extendNo": null,
        "customer": null,
        "polCd": null,
        "customerService": null,
        "noticeEmail": null,
        "remark": null,
        "serviceType": "C"
    }
]

Request Code Samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://api.trackingeyes.com/api/oceanbill/batchOceanBill?companyCode&token&orgCode' \
--header 'Content-Type: application/json' \
--data-raw '[
    {
        "deliveryNo": null,
        "orderNo": null,
        "localKey": "",
        "referenceNo": "177QAZAZXTCN0541",
        "blType": "BL",
        "carrierCd": "MSC",
        "extendNo": null,
        "customer": null,
        "polCd": null,
        "customerService": null,
        "noticeEmail": null,
        "remark": null,
        "serviceType": "C"
    },
    {
        "deliveryNo": null,
        "orderNo": null,
        "localKey": "",
        "referenceNo": "SNLFSKALB61601",
        "blType": "BL",
        "carrierCd": "SINO",
        "extendNo": {
            "CtnrNo": "BHCU4987386"
        },
        "customer": null,
        "polCd": null,
        "customerService": null,
        "noticeEmail": null,
        "remark": null,
        "serviceType": "C"
    },
    {
        "deliveryNo": null,
        "orderNo": null,
        "localKey": "",
        "referenceNo": "6414918850",
        "blType": "",
        "carrierCd": "COSCO",
        "extendNo": null,
        "customer": null,
        "polCd": null,
        "customerService": null,
        "noticeEmail": null,
        "remark": null,
        "serviceType": "C"
    }
]'

Responses

🟢200成功
application/json
Body

Example
{
    "code": 200,
    "type": "success",
    "message": "",
    "result": [
        {
            "resultType": "订阅成功",
            "resultTypeCd": "success",
            "error": "",
            "id": "627472342581317",
            "deliveryNo": null,
            "orderNo": null,
            "localKey": null,
            "referenceNo": "278342554",
            "ctnrNo": null,
            "carrierCd": "MSK",
            "trackStatus": "跟踪中",
            "trackStatusCd": "T",
            "errorMessage": "",
            "errorStatus": "T",
            "billCreateTime": "2024-12-28 11:31:32",
            "dataStatus": null,
            "blType": "BL"
        }
    ],
    "time": "2024-12-28 11:31:32"
}
Modified at 2026-02-03 07:42:44
Previous
海运状态码
Next
推送运单动态接口
Built with