9.3.4 船舶航速异常推送

POST

/push/SpeedAlert

服务介绍

当订阅的船舶航速持续异常（低于最小航速或高于最大航速超过设定的时间阈值）时，系统自动推送告警通知到用户配置的接收URL。推送数据包含船舶信息、事件类型（低于/高于航速区间）、位置、航速、航行状态和时间等。

**注意：**此接口为推送类API，非HTTP请求接口。系统会自动将数据推送到用户在控制台中配置的接收URL，用户无需主动调用。

请求限制

此推送服务需要在控制台中创建配置接收数据的URL。需要先通过SubShipAlertOfSpeed接口订阅船舶航速告警。

推送数据格式

推送地址	推送方式
用户在控制台配置的接收URL	POST

请求参数

Body 参数application/json必填

示例

{
    "data": {
        "mmsi": 0,
        "imo": 0,
        "call_sign": "string",
        "ship_name": "string",
        "event_type": 0,
        "lng": 0,
        "lat": 0,
        "sog": 0,
        "navistat": 0,
        "event_time": "string",
        "event_time_utc": 0
    }
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location '/push/SpeedAlert' \
--header 'Content-Type: application/json' \
--data '{
    "data": {
        "mmsi": 0,
        "imo": 0,
        "call_sign": "string",
        "ship_name": "string",
        "event_type": 0,
        "lng": 0,
        "lat": 0,
        "sog": 0,
        "navistat": 0,
        "event_time": "string",
        "event_time_utc": 0
    }
}'

返回响应

⚪0成功

application/json

推送数据格式参考

Bodyapplication/json

示例

{
    "mmsi":412324692,
    "imo":0,
    "call_sign":"62324",
    "ship_name":"LULONGYU62324",
    "event_type":1,
    "event_time_utc":1770111785,
    "event_time":"2026-02-03 17:43:05",
    "lng":120.445428,
    "lat":37.771586,
    "navstat":255
 }

修改于 2026-06-22 08:34:24

9.3.3 查询订阅船舶列表

9.4 实时船位推送