台风列表

GETPOST 天气

查询当年或指定年份的台风列表，包含台风编号、中英文名、状态等信息

GET https://api.tinyaii.cn/v1/typhoon/list

请求参数

参数名类型必填说明示例
yearinteger可选年份，不填则查询当年—

返回字段

字段类型说明
data.yearinteger查询年份
data.countinteger台风数量
data.typhoons[].idinteger台风ID（查询详情时使用）
data.typhoons[].name_cnstring中文名
data.typhoons[].name_enstring英文名
data.typhoons[].numberstring台风编号
data.typhoons[].statusstring状态：活跃/已停止
data.typhoons[].name_meaningstring名字含义

返回示例

{
  "code": 200,
  "data": {
    "year": 2026,
    "count": 11,
    "typhoons": [
      {
        "id": 3257931,
        "name_cn": "巴威",
        "name_en": "BAVI",
        "number": "2609",
        "status": "活跃",
        "name_meaning": "位于越南北部的山脉"
      }
    ]
  },
  "message": "success"
}

调用示例

curl "https://api.tinyaii.cn/v1/typhoon/list?year=1" \
  -H "Authorization: Bearer YOUR_API_KEY"
const res = await fetch("https://api.tinyaii.cn/v1/typhoon/list?year=1", {
  headers: { "Authorization": "Bearer YOUR_API_KEY" },
});
console.log(await res.json());
import requests

resp = requests.get(
    "https://api.tinyaii.cn/v1/typhoon/list",
    params={"year": "1"},
    headers={"Authorization": "Bearer YOUR_API_KEY"},
    timeout=10,
)
print(resp.json())

把 YOUR_API_KEY 换成你的密钥即可直接运行。密钥只保存在你自己的设备上。