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

集装箱综合跟踪（全量推送）

POST
最后修改时间：2025-07-28 03:04:51
全量变化推送： --应用于全量数据及时更新
1.飞驼获取到变化数据后，第一时间推送 [运单的变更通知]给用户（推送的是订阅参数，不是具体的变化内容）
2.用户接收[消息变更通知]，再次调用[跟踪查询接口]获取最新数据
3.已完成的运单：结束推送，后续如再发生变化，用户需主动调用[跟踪查询接口]获取最新数据。
前置条件：
1.用户需要提供回调地址(注意，不允许带验证)
2.用户需要在集装箱综合跟踪接口进行订阅
签名验证（非必须）：
如需要验证推送接口的，可以进行签名验证（默认可以不做签名验证，需要签名验证请继续阅读）
推送时会使用以下规则进行签名,签名信息存储在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

示例
//订阅参数：
{
    "billNo": "228980179",
    "containerNo": "",
    "carrierCode": "MSK",
    "portCode": "",
    "isExport": "",
    "businessNo": "",
    "billCategory": ""
}
//推送参数：
{
    "referenceno": "228980179",
    "params": [
        {
            "REFERENCE_NO": "228980179",
            "BUSINESSNO": "",
            "CTNRNO": "",
            "CARRIER_CD": "MSK",
            "POL": "",
            "DTP": "",
            "IEMARK": "",
            "CLIENT_ID": "1234567890",
            "BILL_CATEGORY": "",
            "POL_CODE": "",
            "POD_CODE": ""
        }
    ]
}

示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
cURL
curl --location --request POST 'http://openapi.freightower.com' \
--header 'Content-Type: application/json' \
--data-raw '//订阅参数：
{
    "billNo": "228980179",
    "containerNo": "",
    "carrierCode": "MSK",
    "portCode": "",
    "isExport": "",
    "businessNo": "",
    "billCategory": ""
}
//推送参数：
{
    "referenceno": "228980179",
    "params": [
        {
            "REFERENCE_NO": "228980179",
            "BUSINESSNO": "",
            "CTNRNO": "",
            "CARRIER_CD": "MSK",
            "POL": "",
            "DTP": "",
            "IEMARK": "",
            "CLIENT_ID": "1234567890",
            "BILL_CATEGORY": "",
            "POL_CODE": "",
            "POD_CODE": ""
        }
    ]
}'

返回响应

🟢200成功
application/json
Body

示例
{}
上一页
集装箱综合跟踪（订阅+查询）
下一页
集装箱综合跟踪（异常预警推送）
Built with