9.2.1 区域创建

POST

https://api.shipxy.com/apicall/v3/AddArea

接口介绍

为您创建一个新的区域监控，区域创建时需要同时设定区域范围、区域名称、推送url地址以及筛选监控的类型。

请求调用示例

https://api.shipxy.com/apicall/v3/AddArea?key=1F6D701272402D1E7D8D316CCE519123&area_bounds=119.846180,32.345143-119.814280,32.311867-119.4661,32.291067-119.375887,32.213847&area_name=浙江沿海区域1&filter_type=3&fleet_id=3f2062c6-b796-4a03-b923-48628794dd86&url=http://192.186.1.1:8000/shipxy/testdemo

**注：**例子中的 1F6D701272402D1E7D8D316CCE519123 是船讯网的官方 key，已经绑定域名 api.shipxy.com，用户无权也无法使用该 key 获取数据，使用该 key 会返回 status 14 的状态码，提示来源域错误。用户如需试用服务，请在控制台创建自己的key。

请求参数

Body 参数application/json必填

示例

{
    "key": "string",
    "area_bounds": "string",
    "area_name": "string",
    "url": "string",
    "filter_type": 0,
    "ship_type": "string",
    "length": "string",
    "fleet_id": "string"
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://api.shipxy.com/apicall/v3/AddArea' \
--header 'Content-Type: application/json' \
--data '{
    "key": "string",
    "area_bounds": "string",
    "area_name": "string",
    "url": "string",
    "filter_type": 0,
    "ship_type": "string",
    "length": "string",
    "fleet_id": "string"
}'

返回响应

⚪0成功

application/json

成功响应

Bodyapplication/json

示例

{
    "status": 0,
    "msg": "",
    "data": {
        "area_id": "765a03820-31dd-4db6-afd4-9517b81f94e1"
    }
}

修改于 2026-06-22 07:40:30

9.2 区域监控推送

9.2.2 区域更新