船公司箱货跟踪（推送）

POST

最后修改时间：2025-07-28 03:44:39

简要概述：
1.用户需要提供回调地址
2.用户需要在船公司箱货跟踪接口进行订阅
3.订阅后飞驼获取到数据后第一时间发生消息通知用户（推送的是变化的数据，也可当成推送的通知）
4.用户接收消息，根据订阅ID，调用船公司海运跟踪（查询）接口获取最新数据

签名验证：
如需要验证推送接口的，可以进行签名验证（默认不做签名验证，需要签名验证请继续阅读）
推送时会使用以下规则进行签名,签名信息存储在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: 数据

与推送示例一样

headers 信息
x-ft-timestamp: 时间戳
x-ft-nonce: 随机码
x-ft-client: 用户名
x-ft-signature: 签名

请求参数

Body 参数application/json

示例

示例 1：系统事件（初始化事件）只获取到了起始港、目的港（如刚订舱，船司还未公布箱号等数据）示例 2：集装箱事件&运输事件-获取到了提空箱和实际离港数据，则推送事件equipmentEvents和transportEvents示例 3：单证事件-获取到了海关放行数据，则推送单证事件shipmentEvents示例 4：系统事件-本票业务已结束，会推送系统事件-已完成示例 5：单证事件-箱子数量发生变更

{
    "subscriptionUNCode": "订阅ID",
    "equipmentEvents": [],
    "transportEvents": [],
    "shipmentEvents": [],
    "systemEvents": [
        {
            "eventClassifier": "ACT",
            "eventCategory": "SYSTEM",
            "eventTime": "2023-12-01 14:36:39",
            "description": "初始化",
            "systemEventCategory": "INIT"
        }
    ]
}

示例代码

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

cURL

示例 1：系统事件（初始化事件）只获取到了起始港、目的港（如刚订舱，船司还未公布箱号等数据）示例 2：集装箱事件&运输事件-获取到了提空箱和实际离港数据，则推送事件equipmentEvents和transportEvents示例 3：单证事件-获取到了海关放行数据，则推送单证事件shipmentEvents示例 4：系统事件-本票业务已结束，会推送系统事件-已完成示例 5：单证事件-箱子数量发生变更

curl --location --request POST 'http://openapi.freightower.com' \
--header 'Content-Type: application/json' \
--data-raw '{
    "subscriptionUNCode": "订阅ID",
    "equipmentEvents": [],
    "transportEvents": [],
    "shipmentEvents": [],
    "systemEvents": [
        {
            "eventClassifier": "ACT",
            "eventCategory": "SYSTEM",
            "eventTime": "2023-12-01 14:36:39",
            "description": "初始化",
            "systemEventCategory": "INIT"
        }
    ]
}'

返回响应

🟢200成功

application/json

Body

示例

{}

船公司箱货跟踪（查询）

🌏业务覆盖范围