飞驼可视集装箱综合跟踪 API 帮助文档

业务覆盖范围 · 节点状态码 · 订阅与查询接口 + 综合常见问题

本文档说明飞驼可视集装箱综合跟踪 API 的业务覆盖、节点编码和调用方式。接口连接船司、港区、海关与多式联运数据，支持从订舱、提空箱到还空箱的全生命周期跟踪。

文档 01 · 业务覆盖范围

当前已接入全球 97 家主流船公司和 17 个中国主要港区，支持订舱号 BK、提单号 BL、箱号三种查询维度，部分船公司支持内贸航线跟踪。

船公司支持列表（97 家）

下表列出常用船司及其 SCAC、API 传参和查询能力；完整列表以平台实时配置为准。

中国港区支持列表（17 个）

覆盖场景与价值分析

统一的数据覆盖让不同业务可以使用同一套标准节点和接口完成全链路协作。

• 覆盖广度： 一套接口覆盖近百家船司、17 个港区与海关数据。
• 接入成本： 首次请求自动订阅，后续返回最新状态，减少轮询工作量。
• 数据标准： 统一状态码、时间字段和运输方式，便于一次解析。
• 风险前置： 通过预警推送主动发现延误、甩柜、滞留和超期用箱。

文档 02 · 节点状态码

节点时间统一提供计划、预计、实际三类字段：离港使用 STD、ETD、ATD，抵达使用 STA、ETA、ATA；集装箱动态节点共 46 个，覆盖海运物流、放行与多式联运。

运单总状态

订舱状态节点

交通工具节点（places 集合）

集装箱动态节点（Containers 集合）

以下为海运物流、铁路、支线、驳船、仓库和卡车节点的统一编码。

扣留 / 放行节点（11 个）

标准化箱型字典

异常预警节点推送说明（15 类）

异常预警需要使用“集装箱综合跟踪（增量+预警推送）”接口，系统按 eventCode 和规则自动监测。

文档 03 · 集装箱综合跟踪（订阅 + 查询）

接口用于订阅并查询集装箱全程物流数据。首次请求自动订阅，后续请求返回最新数据；可组合船司和中国港区参数，同时获得船司、港区及海关信息。

https://openapi.freightower.com/application/v1/query

请求参数

Header 认证参数

Body 参数（application/json）

请求示例

curl --location 'https://openapi.freightower.com/application/v1/query' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
  "billNo": "177MASASS106510A",
  "containerNo": "TCKU1559530",
  "carrierCode": "MSC",
  "portCode": "CNSHA",
  "isExport": "E"
}'

多种查询模式

• 船司 + 港区： 同时传 carrierCode 与 portCode / isExport。
• 只查订舱号或提单号： 使用 billCategory=BK 或 BL。
• 指定箱号： billNo 与 containerNo 同时传入，只返回该单号下指定箱号。

返回响应

返回示例（节选）

{
  "statusCode": 20000,
  "message": "订阅成功!",
  "data": { "result": {
    "billNo": "177MASASS106510A",
    "statusCategory": "COMPLETE",
    "currentStatus": { "eventCode": "RCVE", "descriptionCn": "还空箱" },
    "places": [], "routes": [], "containers": []
  } }
}