接口

您可以调用 FishBoard 鱼板对外提供的接口,来帮助您将冰点点气象雷达拼图存档接入到您的业务中。

您应当合理、节约地使用接口,不得进行高频爬取等操作。如发现异常或违规情况,本站有权采取限制措施。

GET /preview

获取预览图片

从 FishBoard 提取指定雷达图的预览图片(含水印)。

URL 路由:
接口后接的路由地址是目标雷达图的存档路径。FishBoard 使用 地区+"雷达拼图"/年/月/日/小时/雷达图名称 的格式。

GET 参数:

参数名 必须 说明
size 可传入 0.1~1.0 范围内的浮点数,输出的图片会根据此值进行倍数缩放。例如有一个原大小 100x100 的雷达图,传入 1 将输出 100x100 大小的原图,传入 0.75 将输出 75x75 大小的缩放图。可借用此参数获取需求大小的缩放图。
colorConvert 选择颜色预处理方案,留空则不预处理。目前支持 256 (256色),websafe (Web 安全色)。

响应内容:
content-type image/png

示例:
获取 2025 年 4 月 10 日 01 时 54 分的华东雷达拼图,使用 0.514 倍缩放输出缩略图。
GET /preview/华东雷达拼图/2025/04/10/01/SEVP_AOC_RDCP_SLDAS3_ECREF_AECN_L88_PI_20250409175400000.PNG?size=0.514

GET /list-times

获取已存档时间列表

从 FishBoard 提取指定地区和时间条件下已存档的雷达拼图时间列表。

URL 路由:
接口后接的路由地址是目标雷达图的存档目录,精确到任意条件,支持精确到地区、年、月、日、小时。FishBoard 使用 地区+"雷达拼图"/年/月/日/小时 的格式。

响应内容:
content-type application/json

结构名 类型 说明
根节点 Array[String] 包含数个符合查询条件的时间字符串。

示例:
获取 2025 年 4 月的所有已存档华东雷达拼图
GET /list-times/华东雷达拼图/2025/04

      [
      "20250409220000",
      "20250409220600",
      "20250409221200",
      "20250409221800",
      "20250409222400",
      ...
      ]
      

GET /list-images

获取已存档图片列表

从 FishBoard 提取指定地区和时间条件下已存档的雷达拼图列表。

URL 路由:
接口后接的路由地址是目标雷达图的存档目录,精确到任意条件,支持精确到地区、年、月、日、小时。FishBoard 使用 地区+"雷达拼图"/年/月/日/小时 的格式。

响应内容:
content-type application/json

结构名 类型 说明
根节点 Array[Object] 包含数个符合查询条件的文件信息对象。
Object Object 一个符合条件的存档图信息对象。
filename String 此存档图的文件名(存档路径),可直接传入 /preview 接口使用。
time-str String 此存档图的存档时间,字符串形式,年月日时分秒。
timestamp Int 此存档图存档 10 位时间戳。

示例:
获取 2025 年 4 月 9 日 22 时的所有已存档华东雷达拼图
GET /list-images/华东雷达拼图/2025/04/09/22

      [
        {
          "filename": "\u534e\u4e1c\u96f7\u8fbe\u62fc\u56fe/2025/04/09/22/SEVP_AOC_RDCP_SLDAS3_ECREF_AECN_L88_PI_20250409140000000.PNG",
          "time_str": "20250409220000",
          "timestamp": 1744207200
        },
        {
          "filename": "\u534e\u4e1c\u96f7\u8fbe\u62fc\u56fe/2025/04/09/22/SEVP_AOC_RDCP_SLDAS3_ECREF_AECN_L88_PI_20250409140600000.PNG",
          "time_str": "20250409220600",
          "timestamp": 1744207560
        },
        {
          "filename": "\u534e\u4e1c\u96f7\u8fbe\u62fc\u56fe/2025/04/09/22/SEVP_AOC_RDCP_SLDAS3_ECREF_AECN_L88_PI_20250409141200000.PNG",
          "time_str": "20250409221200",
          "timestamp": 1744207920
        },
        {
          "filename": "\u534e\u4e1c\u96f7\u8fbe\u62fc\u56fe/2025/04/09/22/SEVP_AOC_RDCP_SLDAS3_ECREF_AECN_L88_PI_20250409141800000.PNG",
          "time_str": "20250409221800",
          "timestamp": 1744208280
        },
        {
          "filename": "\u534e\u4e1c\u96f7\u8fbe\u62fc\u56fe/2025/04/09/22/SEVP_AOC_RDCP_SLDAS3_ECREF_AECN_L88_PI_20250409142400000.PNG",
          "time_str": "20250409222400",
          "timestamp": 1744208640
        },
        ...
      ]