1. 🚢 散货/RORO跟踪
飞驼可视接口
简体中文
  • 简体中文
  • English
  • 💡API使用说明
    • 🥇API业务概述
    • 🥈产品效果展示
    • 🥉API对接流程
    • 📋接口状态码
    • 📋坐标系转换
    • 📋接口加密签名
    • ♥️获取Token
      POST
  • ⚓海运集装箱跟踪📌
    • ⚓集装箱综合跟踪-100+船司📌
      • 📋业务覆盖范围-100+船司
      • 📋节点状态码
      • 📋嵌套可视化地图
      • 📌智能甩柜预测
      • 集装箱综合跟踪（订阅+查询）
      • 集装箱综合跟踪（更新通知推送）
      • 集装箱综合跟踪（增量+预警推送）
      • 集装箱综合跟踪（停止推送）
      • 集装箱综合跟踪全程轨迹
      • 箱/单智能识别船公司📌
      • 箱号智能识别提单号📌
    • ⚓船司集装箱跟踪(原始)
      • 📋节点状态码
      • 📋业务覆盖范围
      • 船公司箱货跟踪（订阅）
      • 船公司箱货跟踪（推送）
      • 船公司箱货跟踪（查询）
    • 🏗中国港区+海关跟踪
      • 📋业务覆盖范围
      • 📋节点状态码
      • 中国港区跟踪（订阅）
      • 中国港区跟踪（查询）
      • 中国港区跟踪（推送）
      • 中国海关跟踪（提单号）
      • 中国海关跟踪（报关单号）
    • 🏗国外港区+海关跟踪-170+港•关
      • 📋业务覆盖范围-170+港•关
      • 📋节点状态码
      • 📌美国CES查验站跟踪
      • 海外码头跟踪（订阅）
      • 海外码头跟踪（查询）
      • 美国海关跟踪（订阅）
      • 美国海关跟踪（查询）
      • 美国海关原始数据（订阅+查询）
      • 📌CBP进口商Bond 查询
    • 🚛EIR放单+提/还箱跟踪
      • 📋业务覆盖范围
      • 📋节点状态码
      • 中国EIR跟踪（订阅）
      • 中国EIR跟踪（查询）
    • 🕒全球码头作业计划
      • 📋业务覆盖范围
      • 码头船舶计划
      • 船司航次转码头航次
  • 🚢 散货/RORO跟踪
    • 📋船舶跟踪覆盖范围
    • 📋散货/RORO覆盖范围-40+船司📌
    • 📋散货/RORO节点状态码
    • 📋船舶嵌套可视化地图
    • 📋散货/RORO嵌套可视化地图
    • 散货/RORO货物跟踪（订阅+查询）📌
      POST
    • 散货/RORO货物跟踪（更新通知推送）
      POST
    • 散货/RORO货物跟踪（增量）
      POST
    • 散货/RORO货物跟踪全程轨迹
      POST
    • 船舶AIS定位+ETA（查询）单船
      GET
    • 船舶AIS定位+ETA（查询）多船
      GET
    • 船舶历史轨迹（查询）
      GET
    • 船舶当前挂靠港（查询）
      GET
    • 船舶历史挂靠港（查询）
      GET
    • 船舶轨迹预测📌（查询 ）
      GET
    • 船舶跟踪ETA预测📌（查询）
      GET
    • 船舶档案（查询）
      GET
    • 船舶搜索（查询）
      GET
    • 集装箱港口拥堵分析📌（查询）
      GET
    • RORO港口拥堵分析📌（查询）
      GET
  • 🚂铁路货运跟踪
    • 🚂北美海铁联运
      • 📋业务覆盖范围
      • 📋海铁节点状态码
      • 📋嵌套可视化地图
      • 海铁联运跟踪（订阅+查询）
      • 海铁联运跟踪（更新通知推送）
      • 海铁联运跟踪（增量+预警推送）
      • 海铁联运跟踪（停止推送）
      • 北美铁运实时跟踪（查询）
      • 北美铁运历史跟踪（查询）
    • 🚂中欧+中亚铁路
      • 📋业务覆盖范围
      • 📋嵌套可视化地图
      • 中欧+中亚铁路跟踪（订阅）
      • 中欧+中亚铁路跟踪（查询）
      • 中欧+中亚铁路班期查询
  • 🛫航空货运跟踪
    • 📋业务覆盖范围-超180家
    • 📋节点状态码
    • 📋嵌套可视化地图
    • 航空货运跟踪（订阅）
    • 航空货运跟踪（查询）
    • 航空货运跟踪（推送）
    • 飞机实时跟踪ADSB（查询）
    • 美国海关空运跟踪（查询）
  • 📦快递包裹跟踪
    • 📋业务覆盖范围-超1500家
    • 📋节点状态码
    • 快递跟踪（订阅）
    • 快递跟踪（查询）
    • 快递公司搜索（查询）
  • 🚚国内汽运跟踪
    • 📋嵌套可视化地图
    • 货车定位（查询）
    • 货车定位+ETA（查询）
    • 货车轨迹（查询）
    • 货车综合跟踪（查询）
    • 货车电子围栏（订阅）
    • 货车电子围栏（推送）
    • 货车电子围栏（取消）
    • 地理编码
    • 逆地理编码
  • 📅海运船期计划
    • 📋业务覆盖范围📌
    • 港到港船期（直达+中转）
    • 港到港船期（直达+中转）- 历史
    • 港到港船期（全球直达）
    • 船舶船期（船名+航次）
    • 船舶船期（船名）
  • 🗓航空航班计划
    • 📋业务覆盖范围
    • 全球航班计划
  1. 🚢 散货/RORO跟踪

散货/RORO货物跟踪（增量）

POST
最后修改时间：2026-09-10 03:02:22
该接口主要用于：接收运单的最新状态。  常被应用于微信小程序，微信公众号，邮件，手机短信等消息提醒功能。
配置流程：
1.
使用散货/RORO货物跟踪（订阅+查询）接口，进行订阅；
2.
提供URL回调地址，发给飞驼客服进行配置；
3.
飞驼配置成功，即可接收已订阅运单的实时消息推送；
推送内容说明：
订阅成功时，飞驼会推送该运单当前最新的状态；
跟踪过程中，该运单有变化时，飞驼则实时推送变化的最新事件，该事件包含 ETD/ETA计划，最新的箱动态；
已完成运单，结束推送。
推送签名验证（非必须）：
如需要验证推送接口的，可以进行签名验证（默认可以不做签名验证，需要签名验证请继续阅读）
推送时会使用以下规则进行签名,签名信息存储在headers(参考下边headers信息)中
备注: 签名可以不做验证,数据可以直接从body获取
使用HmacSHA1 签名，参考代码:
    public static String sign(String accessSecret, String stringToSign) throws Exception {
        javax.crypto.Mac mac = javax.crypto.Mac.getInstance("HmacSHA1");
        mac.init(new javax.crypto.spec.SecretKeySpec(accessSecret.getBytes("UTF-8"), "HmacSHA1"));
        byte[] signData = mac.doFinal(stringToSign.getBytes("UTF-8"));
        return new sun.misc.BASE64Encoder().encode(signData);
    }
accessSecret: 密钥, 飞驼提供
stringToSign: 待签名的字符串, 格式: timestamp/nonce/client/data,
timestamp: 时间戳
nonce: 随机码
client: 用户名
data: 数据
如: 1683596662696/6443d0ad-1f5b-4fb8-be34-6e877ec6d742/abc/{
    "referenceno": "QDSM472463",
    "params": [
        {
            "DTP": "",
            "CARRIER_CD": "CMA",
            "IEMARK": "",
            "POL": "",
            "REFERENCE_NO": "QDSM472463",
            "CTNRNO": "TIIU4075445"
        }
    ]
}
headers 信息
x-ft-timestamp: 时间戳
x-ft-nonce: 随机码
x-ft-client: 用户名
x-ft-signature: 签名

请求参数

Body 参数application/json

示例
{
    "param": {
        "billNo": "NYKS220013049",
        "carrierCode": "NYK",
        "polCode": "CNSHA",
        "podCode": "THLCH"
    },
    "result": {
        "billCategory": null,
        "statusCategory": "PROCESS",
        "statusDescription": "Shipment updating",
        "endTime": null,
        "updateTime": "2026/09/09 19:09:38",
        "carrier": {
            "code": "NYK"
        },
        "places": [
            {
                "code": "CNSHA",
                "name": "SHANGHAI",
                "nameCn": "上海",
                "nameOrigin": "CNSHA",
                "type": 1,
                "lat": 30.61952,
                "lon": 122.057942,
                "portTimeZone": "8",
                "transportMode_in": "TRUCK",
                "containerCount_in": "1/1",
                "sta": "2026/08/14 13:00:00",
                "eta": "2026/08/14 13:00:00",
                "terminalName": null,
                "eta_predicted": null,
                "ata": "2026/08/14 13:10:26",
                "std": "2026/08/22 00:00:00",
                "etd": "2026/08/22 00:00:00",
                "load": "2026/08/21 22:30:00",
                "atd": "2026/08/22 03:30:00",
                "atdSource": 1,
                "atd_ais": "2026/08/22 03:53:53",
                "atbd_ais": "2026/08/22 03:59:35",
                "vessel": "VIKING SYDNEY",
                "voyage": "015",
                "transportMode_out": "VESSEL",
                "containerCount_out": "1/1"
            },
            {
                "code": "CNSHA",
                "name": "SHANGHAI",
                "nameCn": "上海",
                "nameOrigin": "CNSHA",
                "type": 2,
                "lat": 30.61952,
                "lon": 122.057942,
                "portTimeZone": "8",
                "transportMode_in": "TRUCK",
                "containerCount_in": "1/1",
                "terminalName": null,
                "sta": "2026/08/14 13:00:00",
                "eta": "2026/08/14 13:00:00",
                "eta_predicted": null,
                "ata": "2026/08/14 13:10:26",
                "ata_ais": "2026/08/21 05:45:41",
                "atb_ais": "2026/08/21 05:52:21",
                "disc": null,
                "std": "2026/08/22 00:00:00",
                "etd": "2026/08/22 00:00:00",
                "load": "2026/08/21 22:30:00",
                "atd": "2026/08/22 03:30:00",
                "atdSource": 1,
                "atd_ais": "2026/08/22 03:53:53",
                "atbd_ais": "2026/08/22 03:59:35",
                "vessel": "VIKING SYDNEY",
                "voyage": "015",
                "transportMode_out": "VESSEL",
                "containerCount_out": "1/1"
            },
            {
                "code": "THLCH",
                "name": "LAEM CHABANG",
                "nameCn": "林查班",
                "nameOrigin": "THLCH",
                "type": 4,
                "lat": 13.051893,
                "lon": 100.893988,
                "portTimeZone": "7",
                "transportMode_in": "UNKNOWN",
                "containerCount_in": "0/1",
                "terminalName": null,
                "firmsCode": null,
                "sta": null,
                "eta": null,
                "eta_ft": null,
                "eta_predicted": null,
                "ata": null,
                "ata_ais": null,
                "atb_ais": null,
                "disc": null,
                "std": null,
                "etd": null,
                "load": null,
                "atd": null,
                "atdSource": null,
                "atd_ais": null,
                "atbd_ais": null,
                "vessel": "VIKING SYDNEY",
                "voyage": "015",
                "transportMode_out": "TRUCK",
                "containerCount_out": "0/1"
            },
            {
                "code": "THLCH",
                "name": "LAEM CHABANG",
                "nameCn": "林查班",
                "nameOrigin": "THLCH",
                "type": 5,
                "lat": 13.051893,
                "lon": 100.893988,
                "portTimeZone": "7",
                "transportMode_in": "UNKNOWN",
                "containerCount_in": "0/1",
                "terminalName": null,
                "firmsCode": null,
                "sta": null,
                "eta": null,
                "eta_ft": null,
                "eta_predicted": null,
                "ata": null,
                "ata_ais": null,
                "atb_ais": null,
                "disc": null,
                "std": null,
                "etd": null,
                "load": null,
                "atd": null,
                "atdSource": null,
                "vessel": "VIKING SYDNEY",
                "voyage": "015",
                "transportMode_out": "TRUCK",
                "containerCount_out": "0/1"
            }
        ],
        "containers": [
            {
                "containerType": null,
                "containerSize": null,
                "containerTypeGroup": null,
                "containerNo": "RORO000078",
                "sealNo": null,
                "offLoadOfCarrier": false,
                "serviceType": null,
                "dbtype": 1,
                "status": [
                    {
                        "statusId": "0f4ad4eac8e515157cdd9e8de3437bdd",
                        "transportMode": "TRUCK",
                        "vslName": null,
                        "voy": null,
                        "eventCode": "GITM",
                        "eventTime": "2026/08/14 13:10:26",
                        "isEsti": "N",
                        "eventPlace": "SHANGHAI",
                        "portTimeZone": "8",
                        "descriptionCn": "进场",
                        "descriptionEn": "Received",
                        "eventPlaceOrigin": "CNSHA",
                        "eventDescriptionOrigin": "Received",
                        "portCode": "CNSHA",
                        "terminalName": null,
                        "firmsCode": null,
                        "billNO": null,
                        "declarationNo": null,
                        "source": 1,
                        "dbtype": 1
                    },
                    {
                        "statusId": "534b76c79d5a9247292204ad671b4eb5",
                        "transportMode": "VESSEL",
                        "vslName": "VIKING SYDNEY",
                        "voy": "015",
                        "eventCode": "LOBD",
                        "eventTime": "2026/08/21 22:30:00",
                        "isEsti": "N",
                        "eventPlace": "SHANGHAI",
                        "portTimeZone": "8",
                        "descriptionCn": "装船",
                        "descriptionEn": "Loaded",
                        "eventPlaceOrigin": "CNSHA",
                        "eventDescriptionOrigin": "Loaded",
                        "portCode": "CNSHA",
                        "terminalName": null,
                        "firmsCode": null,
                        "billNO": null,
                        "declarationNo": null,
                        "source": 1,
                        "dbtype": 1
                    },
                    {
                        "statusId": "25f0f332eb55bf5e170582525214b349",
                        "transportMode": "VESSEL",
                        "vslName": "VIKING SYDNEY",
                        "voy": "015",
                        "eventCode": "DLPT",
                        "eventTime": "2026/08/22 03:30:00",
                        "isEsti": "N",
                        "eventPlace": "SHANGHAI",
                        "portTimeZone": "8",
                        "descriptionCn": "离港",
                        "descriptionEn": "Vessel Departed",
                        "eventPlaceOrigin": "CNSHA",
                        "eventDescriptionOrigin": "Vessel Departed",
                        "portCode": "CNSHA",
                        "terminalName": null,
                        "firmsCode": null,
                        "billNO": null,
                        "declarationNo": null,
                        "source": 1,
                        "dbtype": 1
                    }
                ]
            }
        ]
    }
}

请求示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location 'http://openapi.freightower.com' \
--header 'Content-Type: application/json' \
--data '{
    "param": {
        "billNo": "NYKS220013049",
        "carrierCode": "NYK",
        "polCode": "CNSHA",
        "podCode": "THLCH"
    },
    "result": {
        "billCategory": null,
        "statusCategory": "PROCESS",
        "statusDescription": "Shipment updating",
        "endTime": null,
        "updateTime": "2026/09/09 19:09:38",
        "carrier": {
            "code": "NYK"
        },
        "places": [
            {
                "code": "CNSHA",
                "name": "SHANGHAI",
                "nameCn": "上海",
                "nameOrigin": "CNSHA",
                "type": 1,
                "lat": 30.61952,
                "lon": 122.057942,
                "portTimeZone": "8",
                "transportMode_in": "TRUCK",
                "containerCount_in": "1/1",
                "sta": "2026/08/14 13:00:00",
                "eta": "2026/08/14 13:00:00",
                "terminalName": null,
                "eta_predicted": null,
                "ata": "2026/08/14 13:10:26",
                "std": "2026/08/22 00:00:00",
                "etd": "2026/08/22 00:00:00",
                "load": "2026/08/21 22:30:00",
                "atd": "2026/08/22 03:30:00",
                "atdSource": 1,
                "atd_ais": "2026/08/22 03:53:53",
                "atbd_ais": "2026/08/22 03:59:35",
                "vessel": "VIKING SYDNEY",
                "voyage": "015",
                "transportMode_out": "VESSEL",
                "containerCount_out": "1/1"
            },
            {
                "code": "CNSHA",
                "name": "SHANGHAI",
                "nameCn": "上海",
                "nameOrigin": "CNSHA",
                "type": 2,
                "lat": 30.61952,
                "lon": 122.057942,
                "portTimeZone": "8",
                "transportMode_in": "TRUCK",
                "containerCount_in": "1/1",
                "terminalName": null,
                "sta": "2026/08/14 13:00:00",
                "eta": "2026/08/14 13:00:00",
                "eta_predicted": null,
                "ata": "2026/08/14 13:10:26",
                "ata_ais": "2026/08/21 05:45:41",
                "atb_ais": "2026/08/21 05:52:21",
                "disc": null,
                "std": "2026/08/22 00:00:00",
                "etd": "2026/08/22 00:00:00",
                "load": "2026/08/21 22:30:00",
                "atd": "2026/08/22 03:30:00",
                "atdSource": 1,
                "atd_ais": "2026/08/22 03:53:53",
                "atbd_ais": "2026/08/22 03:59:35",
                "vessel": "VIKING SYDNEY",
                "voyage": "015",
                "transportMode_out": "VESSEL",
                "containerCount_out": "1/1"
            },
            {
                "code": "THLCH",
                "name": "LAEM CHABANG",
                "nameCn": "林查班",
                "nameOrigin": "THLCH",
                "type": 4,
                "lat": 13.051893,
                "lon": 100.893988,
                "portTimeZone": "7",
                "transportMode_in": "UNKNOWN",
                "containerCount_in": "0/1",
                "terminalName": null,
                "firmsCode": null,
                "sta": null,
                "eta": null,
                "eta_ft": null,
                "eta_predicted": null,
                "ata": null,
                "ata_ais": null,
                "atb_ais": null,
                "disc": null,
                "std": null,
                "etd": null,
                "load": null,
                "atd": null,
                "atdSource": null,
                "atd_ais": null,
                "atbd_ais": null,
                "vessel": "VIKING SYDNEY",
                "voyage": "015",
                "transportMode_out": "TRUCK",
                "containerCount_out": "0/1"
            },
            {
                "code": "THLCH",
                "name": "LAEM CHABANG",
                "nameCn": "林查班",
                "nameOrigin": "THLCH",
                "type": 5,
                "lat": 13.051893,
                "lon": 100.893988,
                "portTimeZone": "7",
                "transportMode_in": "UNKNOWN",
                "containerCount_in": "0/1",
                "terminalName": null,
                "firmsCode": null,
                "sta": null,
                "eta": null,
                "eta_ft": null,
                "eta_predicted": null,
                "ata": null,
                "ata_ais": null,
                "atb_ais": null,
                "disc": null,
                "std": null,
                "etd": null,
                "load": null,
                "atd": null,
                "atdSource": null,
                "vessel": "VIKING SYDNEY",
                "voyage": "015",
                "transportMode_out": "TRUCK",
                "containerCount_out": "0/1"
            }
        ],
        "containers": [
            {
                "containerType": null,
                "containerSize": null,
                "containerTypeGroup": null,
                "containerNo": "RORO000078",
                "sealNo": null,
                "offLoadOfCarrier": false,
                "serviceType": null,
                "dbtype": 1,
                "status": [
                    {
                        "statusId": "0f4ad4eac8e515157cdd9e8de3437bdd",
                        "transportMode": "TRUCK",
                        "vslName": null,
                        "voy": null,
                        "eventCode": "GITM",
                        "eventTime": "2026/08/14 13:10:26",
                        "isEsti": "N",
                        "eventPlace": "SHANGHAI",
                        "portTimeZone": "8",
                        "descriptionCn": "进场",
                        "descriptionEn": "Received",
                        "eventPlaceOrigin": "CNSHA",
                        "eventDescriptionOrigin": "Received",
                        "portCode": "CNSHA",
                        "terminalName": null,
                        "firmsCode": null,
                        "billNO": null,
                        "declarationNo": null,
                        "source": 1,
                        "dbtype": 1
                    },
                    {
                        "statusId": "534b76c79d5a9247292204ad671b4eb5",
                        "transportMode": "VESSEL",
                        "vslName": "VIKING SYDNEY",
                        "voy": "015",
                        "eventCode": "LOBD",
                        "eventTime": "2026/08/21 22:30:00",
                        "isEsti": "N",
                        "eventPlace": "SHANGHAI",
                        "portTimeZone": "8",
                        "descriptionCn": "装船",
                        "descriptionEn": "Loaded",
                        "eventPlaceOrigin": "CNSHA",
                        "eventDescriptionOrigin": "Loaded",
                        "portCode": "CNSHA",
                        "terminalName": null,
                        "firmsCode": null,
                        "billNO": null,
                        "declarationNo": null,
                        "source": 1,
                        "dbtype": 1
                    },
                    {
                        "statusId": "25f0f332eb55bf5e170582525214b349",
                        "transportMode": "VESSEL",
                        "vslName": "VIKING SYDNEY",
                        "voy": "015",
                        "eventCode": "DLPT",
                        "eventTime": "2026/08/22 03:30:00",
                        "isEsti": "N",
                        "eventPlace": "SHANGHAI",
                        "portTimeZone": "8",
                        "descriptionCn": "离港",
                        "descriptionEn": "Vessel Departed",
                        "eventPlaceOrigin": "CNSHA",
                        "eventDescriptionOrigin": "Vessel Departed",
                        "portCode": "CNSHA",
                        "terminalName": null,
                        "firmsCode": null,
                        "billNO": null,
                        "declarationNo": null,
                        "source": 1,
                        "dbtype": 1
                    }
                ]
            }
        ]
    }
}'

返回响应

🟢200成功
application/json
Bodyapplication/json

示例
{}
上一页
散货/RORO货物跟踪（更新通知推送）
下一页
散货/RORO货物跟踪全程轨迹
Built with