9.2.2 区域更新

POST

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

接口介绍

更新区域信息，包括区域范围、区域名称、推送url地址以及筛选监控的类型。

请求调用示例

https://api.shipxy.com/apicall/v3/UpdateArea?key=1F6D701272402D1E7D8D316CCE519123&area_id=65a03820-31dd-4db6-afd4-9517b81f94e1&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": "1F6D701272402D1E7D8D316CCE519123",
    "area_id": "65a03820-31dd-4db6-afd4-9517b81f94e1",
    "area_bounds": "119.846180,32.345143-119.814280,32.311867-119.4661,32.291067-119.375887,32.213847",
    "url": "http://192.186.1.1:8000/shipxy/testdemo",
    "area_name": "浙江沿海区域",
    "filter_type": 3,
    "ship_type": "80",
    "length": "4",
    "fleet_id": "3f2062c6-b796-4a03-b923-48628794dd86"
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://api.shipxy.com/apicall/v3/UpdateArea' \
--header 'Content-Type: application/json' \
--data '{
    "key": "1F6D701272402D1E7D8D316CCE519123",
    "area_id": "65a03820-31dd-4db6-afd4-9517b81f94e1",
    "area_bounds": "119.846180,32.345143-119.814280,32.311867-119.4661,32.291067-119.375887,32.213847",
    "url": "http://192.186.1.1:8000/shipxy/testdemo",
    "area_name": "浙江沿海区域",
    "filter_type": 3,
    "ship_type": "80",
    "length": "4",
    "fleet_id": "3f2062c6-b796-4a03-b923-48628794dd86"
}'

返回响应

⚪0成功

application/json

成功响应

Bodyapplication/json

示例

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

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

9.2.1 区域创建

9.2.3 区域查询