港口潮汐预报

访问限制

本部分 API 属于增值服务，仅提供给企业套餐开发者，如需采购请联系彩云商务

港口查询 API

• 错误信息

请求

GET https://singer.caiyunhub.com/v3/sea/tide/ports

查询参数

参数	必填	默认值	取值范围	说明
token	是	—	—	API 认证凭证，详见 认证与鉴权
adcode	否	—	—	区域代码，支持前缀匹配。例如雷州港口可通过 440882（雷州市）、440800（湛江市）或 440000（广东省）匹配

请求示例

# 获取所有港口
curl "https://singer.caiyunhub.com/v3/sea/tide/ports?token={token}"

# 根据 adcode 过滤港口
curl "https://singer.caiyunhub.com/v3/sea/tide/ports?token={token}&adcode={adcode}"

响应示例

{
  "ports": [
    { "id": "T016", "name": "菊花岛", "coordinates": [120.83333, 40.48333], "adcode": "211400" },
    { "id": "T199", "name": "白龙尾", "coordinates": [108.23333, 21.5], "adcode": "450603" }
  ]
}

响应字段

JSONPath	类型	说明
$.ports	array<object>	港口列表
$.ports[].id	string	港口编号
$.ports[].name	string	港口名称
$.ports[].coordinates	array<number>	港口坐标，顺序为经度、纬度
$.ports[].adcode	string	区域代码，部分港口可能没有该字段

港口潮汐预报 API

• 错误信息

请求

GET https://singer.caiyunhub.com/v3/sea/tide/by_port

查询参数

参数	必填	默认值	取值范围	说明
token	是	—	—	API 认证凭证，详见 认证与鉴权
ids	是	—	—	港口 ID；多个 ID 使用逗号分隔，all 表示全部港口
days	是	—	1~7	返回天数

请求示例

# 默认 API 调用格式
curl "https://singer.caiyunhub.com/v3/sea/tide/by_port?ids=T016&token={token}&days={days}"

# 只获取部分港口潮汐预报数据
curl "https://singer.caiyunhub.com/v3/sea/tide/by_port?ids=a,b,c&token={token}&days=3"

# 获取全部港口的潮汐预报数据
curl "https://singer.caiyunhub.com/v3/sea/tide/by_port?ids=all&token={token}&days=3"

响应示例

{
  "tide": [
    {
      "id": "T016",
      "date": "2024-11-04",
      "tide": [
        47,
        56,
        88,
        136,
        191,
        241,
        276,
        286,
        269,
        227,
        171,
        113,
        68,
        44,
        45,
        67,
        102,
        139,
        169,
        184,
        177,
        151,
        113,
        74
      ],
      "event_time": [
        "00:08",
        "06:53",
        "13:27",
        "19:12"
      ],
      "event_tide": [
        46,
        286,
        42,
        184
      ]
    },
    {
      "id": "T016",
      "date": "2024-11-05",
      "tide": [
        48,
        44,
        65,
        107,
        162,
        219,
        265,
        291,
        290,
        262,
        213,
        153,
        97,
        58,
        42,
        50,
        77,
        112,
        146,
        170,
        176,
        163,
        132,
        94
      ],
      "event_time": [
        "00:40",
        "07:29",
        "14:08",
        "19:49"
      ],
      "event_tide": [
        43,
        294,
        42,
        177
      ]
    }
  ]
}

响应字段

JSONPath	类型	说明
$.tide	array<object>	潮汐预报列表
$.tide[].id	string	港口编号
$.tide[].date	string	日期
$.tide[].tide	array<number>	潮高，共 24 个值，代表各整点时的潮高
$.tide[].event_time	array<string>	事件时间点
$.tide[].event_tide	array<number>	事件潮高