飞驼可视接口
  1. 🚂北美海铁联运
飞驼可视接口
  • 💡API使用说明
    • 🏅API业务概述
    • 📋API对接流程
    • 📋接口状态码
    • 获取Token
      POST
  • 📦集装箱跟踪
    • 📦集装箱综合跟踪
      • 📌智能甩柜预测
      • 📋业务覆盖范围-超80家
      • 📋节点状态码
      • 📋嵌套可视化地图
      • 集装箱综合跟踪（订阅+查询）
      • 集装箱综合跟踪（更新通知推送）
      • 集装箱综合跟踪（增量+预警推送）
      • 集装箱综合跟踪（停止推送）
      • 箱/单智能识别船公司📌
      • 箱号智能识别提单号📌
    • 🚢船司集装箱跟踪
      • 📋业务覆盖范围
      • 📋节点状态码
      • 船公司箱货跟踪（订阅）
      • 船公司箱货跟踪（查询）
      • 船公司箱货跟踪（推送）
    • 🏗中国港区+海关跟踪
      • 📋业务覆盖范围
      • 📋节点状态码
      • 中国港区跟踪（订阅）
      • 中国港区跟踪（查询）
      • 中国港区跟踪（推送）
      • 中国海关跟踪（提单号）
      • 中国海关跟踪（报关单号）
    • 🏗国外港区+海关跟踪
      • 📌美国CES查验站跟踪
      • 📋业务覆盖范围
      • 📋节点状态码
      • 海外码头跟踪（订阅）
      • 海外码头跟踪（查询）
      • 美国海关跟踪（订阅）
      • 美国海关跟踪（查询）
      • 美国海关原始数据（查询）
    • 🚛EIR放单+提箱跟踪
      • 📋业务覆盖范围
      • 📋节点状态码
      • 中国EIR跟踪（订阅）
      • 中国EIR跟踪（查询）
    • 🕒码头作业计划
      • 📋业务覆盖范围
      • 码头船舶计划
      • 船司航次转码头航次
  • 🛳 全球船舶跟踪
    • 📋业务覆盖范围
    • 📋嵌套可视化地图
    • 船舶AIS定位+ETA（查询）
      GET
    • 船舶历史轨迹（查询）
      GET
    • 船舶当前挂靠港（查询）
      GET
    • 船舶历史挂靠港（查询）
      GET
    • 海运港拥堵分析📌（查询）
      GET
    • RORO港拥堵分析📌（查询）
      GET
    • 船舶跟踪ETA预测📌（查询）
      GET
    • 船舶档案（查询）
      GET
    • 船舶搜索（查询）
      GET
  • 🛫航空货运跟踪
    • 📋业务覆盖范围
    • 📋节点状态码
    • 📋嵌套可视化地图
    • 航空货运跟踪（订阅）
    • 航空货运跟踪（查询）
    • 航空货运跟踪（推送）
    • 航班实时跟踪ADSB（查询）
    • 美国海关跟踪（查询）
    • 美国海关原始数据（查询）
  • 🚂铁路货运跟踪
    • 🚂北美海铁联运
      • 📋业务覆盖范围
      • 📋海铁节点状态码
      • 📋嵌套可视化地图
      • 海铁联运跟踪（订阅+查询）
        POST
      • 海铁联运跟踪（更新通知推送）
        POST
      • 海铁联运跟踪（增量+预警推送）
        POST
      • 北美铁运实时跟踪（查询）
        GET
      • 北美铁运历史跟踪（查询）
        GET
    • 🚂中欧+中亚铁路
      • 📋业务覆盖范围
      • 📋嵌套可视化地图
      • 中欧+中亚铁路跟踪（订阅）
      • 中欧+中亚铁路跟踪（查询）
  • 🚚国内汽运跟踪
    • 📋嵌套可视化地图
    • 货车定位（查询）
    • 货车定位+ETA（查询）
    • 货车轨迹（查询）
    • 货车综合跟踪（查询）
    • 货车电子围栏（订阅）
    • 货车电子围栏（推送）
  • 📅海运船期计划
    • 📋业务覆盖范围📌
    • 港到港船期（直达+中转）- 新版
    • 港到港船期（直达+中转）
    • 港到港船期（全球直达）
    • 船舶船期（船名+航次）
    • 船舶船期（船名）
  • 🗓航空航班计划
    • 📋业务覆盖范围
    • 全球航班计划
  1. 🚂北美海铁联运

海铁联运跟踪（增量+预警推送）

POST
最后修改时间：2025-11-07 04:19:57
事件变化和预警推送：--应用于微信小程序/邮件的运单变化提醒
1.飞驼获取到变化数据后，第一时间推送[变化事件内容] (包含：计划、实际、预警事件)给用户
2.用户接收[变化事件内容]，可直接 推送给客户
3.已完成的运单：结束推送，后续如再发生变化，用户需主动调用【北美海铁联运跟踪（订阅+查询）接口】获取最新数据。
推送签名验证（非必须）：
如需要验证推送接口的，可以进行签名验证（默认可以不做签名验证，需要签名验证请继续阅读）
推送时会使用以下规则进行签名,签名信息存储在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": "6417148220",
        "containerNo": null,
        "carrierCode": "COSCO",
        "polCode": null,
        "podCode": null,
        "billCategory": null
    },
    "result": {
        "billCategory": "BK",
        "statusCategory": "PROCESS",
        "statusDescription": "Shipment updating",
        "endTime": null,
        "updateTime": "2025/05/15 04:01:08",
        "carrier": {
            "code": "COSCO"
        },
        "places": [
            {
                "code": "CNTXG",
                "name": "TIANJIN(XINGANG)",
                "nameCn": "天津",
                "nameOrigin": "Xingang",
                "type": 1,
                "lat": 38.9906,
                "lon": 117.72135,
                "portTimeZone": "8",
                "sta": null,
                "eta": null,
                "ata": null,
                "std": "2025/05/14 07:30:00",
                "etd": "2025/05/15 16:00:00",
                "load": null,
                "atd": null,
                "atd_ais": null,
                "vessel": "XIN CANG ZHOU",
                "voyage": "284S",
                "terminalName": null
            },
            {
                "code": "CNTXG",
                "name": "TIANJIN(XINGANG)",
                "nameCn": "天津",
                "nameOrigin": "Xingang",
                "type": 2,
                "lat": 38.9906,
                "lon": 117.72135,
                "portTimeZone": "8",
                "sta": null,
                "eta": null,
                "ata": null,
                "std": "2025/05/14 07:30:00",
                "etd": "2025/05/15 16:00:00",
                "load": null,
                "atd": null,
                "atd_ais": null,
                "vessel": "XIN CANG ZHOU",
                "voyage": "284S",
                "terminalName": null
            },
            {
                "code": "CNNGB",
                "name": "NINGBO",
                "nameCn": "宁波",
                "nameOrigin": "Ningbo",
                "type": 3,
                "lat": 29.972047,
                "lon": 121.876042,
                "portTimeZone": "8",
                "sta": null,
                "eta": "2025/05/23 09:30:00",
                "ata": null,
                "ata_ais": null,
                "disc": null,
                "std": null,
                "etd": "2025/05/25 14:00:00",
                "load": null,
                "atd": null,
                "atd_ais": null,
                "vessel": "OOCL DURBAN",
                "voyage": "031S",
                "terminalName": null
            },
            {
                "code": "AUSYD",
                "name": "SYDNEY",
                "nameCn": "悉尼",
                "nameOrigin": "Sydney",
                "type": 4,
                "lat": -33.851505,
                "lon": 151.19885,
                "portTimeZone": "10",
                "sta": "2025/06/05 14:00:00",
                "eta": "2025/06/05 14:00:00",
                "ata": null,
                "ata_ais": null,
                "atb_ais": null,
                "disc": null,
                "std": null,
                "etd": null,
                "atd": null,
                "vessel": "OOCL DURBAN",
                "voyage": "031S",
                "terminalName": null,
                "firmsCode": null
            },
            {
                "code": "AUSYD",
                "name": "SYDNEY",
                "nameCn": "悉尼",
                "nameOrigin": "Sydney",
                "type": 5,
                "lat": -33.851505,
                "lon": 151.19885,
                "portTimeZone": "10",
                "sta": "2025/06/05 14:00:00",
                "eta": "2025/06/08 06:00:00",
                "ata": null,
                "ata_ais": null,
                "atb_ais": null,
                "disc": null,
                "std": null,
                "etd": null,
                "atd": null,
                "vessel": "OOCL DURBAN",
                "voyage": "031S",
                "terminalName": null,
                "firmsCode": null
            }
        ],
        "containers": [
            {
                "containerType": "GP",
                "containerSize": "20",
                "containerTypeGroup": "20GP",
                "containerNo": "OOCU0863070",
                "sealNo": null,
                "offLoadOfCarrier": false,
                "dbtype": 2,
                "status": [
                    {
                        "transportMode": "VESSEL",
                        "vslName": "XIN CANG ZHOU",
                        "voy": "284S",
                        "eventCode": "DLPT",
                        "eventTime": "2025/05/15 16:00:00",
                        "isEsti": "Y",
                        "eventPlace": "TIANJIN(XINGANG)",
                        "portTimeZone": "8",
                        "descriptionCn": "离港",
                        "descriptionEn": "Vessel Departed",
                        "eventPlaceOrigin": "Xingang",
                        "eventDescriptionOrigin": "Vessel Departure",
                        "portCode": "CNTXG",
                        "terminalName": null,
                        "firmsCode": null,
                        "billNO": null,
                        "declarationNo": null,
                        "source": 1,
                        "dbtype": 2
                    }
                ],
                "warnings": [
                    {
                        "eventCategory": "DELAY",
                        "eventCode": "WGITM",
                        "eventTime": "2025-05-13 16:00:00",
                        "portCode": "CNTXG",
                        "portPlace": "TIANJIN(XINGANG)",
                        "equipmentCode": "OOCU0863070",
                        "description": "起运港船舶离港前48小时还未进港;\n ETD:2025/05/15 16:00:00"
                    }
                ]
            }
        ]
    }
}

请求示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST 'http://openapi.freightower.com' \
--header 'Content-Type: application/json' \
--data-raw '{
    "param": {
        "billNo": "6417148220",
        "containerNo": null,
        "carrierCode": "COSCO",
        "polCode": null,
        "podCode": null,
        "billCategory": null
    },
    "result": {
        "billCategory": "BK",
        "statusCategory": "PROCESS",
        "statusDescription": "Shipment updating",
        "endTime": null,
        "updateTime": "2025/05/15 04:01:08",
        "carrier": {
            "code": "COSCO"
        },
        "places": [
            {
                "code": "CNTXG",
                "name": "TIANJIN(XINGANG)",
                "nameCn": "天津",
                "nameOrigin": "Xingang",
                "type": 1,
                "lat": 38.9906,
                "lon": 117.72135,
                "portTimeZone": "8",
                "sta": null,
                "eta": null,
                "ata": null,
                "std": "2025/05/14 07:30:00",
                "etd": "2025/05/15 16:00:00",
                "load": null,
                "atd": null,
                "atd_ais": null,
                "vessel": "XIN CANG ZHOU",
                "voyage": "284S",
                "terminalName": null
            },
            {
                "code": "CNTXG",
                "name": "TIANJIN(XINGANG)",
                "nameCn": "天津",
                "nameOrigin": "Xingang",
                "type": 2,
                "lat": 38.9906,
                "lon": 117.72135,
                "portTimeZone": "8",
                "sta": null,
                "eta": null,
                "ata": null,
                "std": "2025/05/14 07:30:00",
                "etd": "2025/05/15 16:00:00",
                "load": null,
                "atd": null,
                "atd_ais": null,
                "vessel": "XIN CANG ZHOU",
                "voyage": "284S",
                "terminalName": null
            },
            {
                "code": "CNNGB",
                "name": "NINGBO",
                "nameCn": "宁波",
                "nameOrigin": "Ningbo",
                "type": 3,
                "lat": 29.972047,
                "lon": 121.876042,
                "portTimeZone": "8",
                "sta": null,
                "eta": "2025/05/23 09:30:00",
                "ata": null,
                "ata_ais": null,
                "disc": null,
                "std": null,
                "etd": "2025/05/25 14:00:00",
                "load": null,
                "atd": null,
                "atd_ais": null,
                "vessel": "OOCL DURBAN",
                "voyage": "031S",
                "terminalName": null
            },
            {
                "code": "AUSYD",
                "name": "SYDNEY",
                "nameCn": "悉尼",
                "nameOrigin": "Sydney",
                "type": 4,
                "lat": -33.851505,
                "lon": 151.19885,
                "portTimeZone": "10",
                "sta": "2025/06/05 14:00:00",
                "eta": "2025/06/05 14:00:00",
                "ata": null,
                "ata_ais": null,
                "atb_ais": null,
                "disc": null,
                "std": null,
                "etd": null,
                "atd": null,
                "vessel": "OOCL DURBAN",
                "voyage": "031S",
                "terminalName": null,
                "firmsCode": null
            },
            {
                "code": "AUSYD",
                "name": "SYDNEY",
                "nameCn": "悉尼",
                "nameOrigin": "Sydney",
                "type": 5,
                "lat": -33.851505,
                "lon": 151.19885,
                "portTimeZone": "10",
                "sta": "2025/06/05 14:00:00",
                "eta": "2025/06/08 06:00:00",
                "ata": null,
                "ata_ais": null,
                "atb_ais": null,
                "disc": null,
                "std": null,
                "etd": null,
                "atd": null,
                "vessel": "OOCL DURBAN",
                "voyage": "031S",
                "terminalName": null,
                "firmsCode": null
            }
        ],
        "containers": [
            {
                "containerType": "GP",
                "containerSize": "20",
                "containerTypeGroup": "20GP",
                "containerNo": "OOCU0863070",
                "sealNo": null,
                "offLoadOfCarrier": false,
                "dbtype": 2,
                "status": [
                    {
                        "transportMode": "VESSEL",
                        "vslName": "XIN CANG ZHOU",
                        "voy": "284S",
                        "eventCode": "DLPT",
                        "eventTime": "2025/05/15 16:00:00",
                        "isEsti": "Y",
                        "eventPlace": "TIANJIN(XINGANG)",
                        "portTimeZone": "8",
                        "descriptionCn": "离港",
                        "descriptionEn": "Vessel Departed",
                        "eventPlaceOrigin": "Xingang",
                        "eventDescriptionOrigin": "Vessel Departure",
                        "portCode": "CNTXG",
                        "terminalName": null,
                        "firmsCode": null,
                        "billNO": null,
                        "declarationNo": null,
                        "source": 1,
                        "dbtype": 2
                    }
                ],
                "warnings": [
                    {
                        "eventCategory": "DELAY",
                        "eventCode": "WGITM",
                        "eventTime": "2025-05-13 16:00:00",
                        "portCode": "CNTXG",
                        "portPlace": "TIANJIN(XINGANG)",
                        "equipmentCode": "OOCU0863070",
                        "description": "起运港船舶离港前48小时还未进港;\n ETD:2025/05/15 16:00:00"
                    }
                ]
            }
        ]
    }
}'

返回响应

🟢200成功
application/json
Body

示例
{}
上一页
海铁联运跟踪（更新通知推送）
下一页
北美铁运实时跟踪（查询）
Built with