加载接口文档…
1.3万
累计调用
104ms
平均响应
100.00%
服务可用性
1,000 次/日
免费额度
访问限制
查看更多方案 →无 Key 调用
每日 500 次 · QPS 5
登录免费
当前方案每日 1,000 次 · QPS 10
黄金会员
每日 50,000 次 · QPS 60
企业会员
每日 1,000,000 次 · QPS 120
文档链接
复制文档地址
https://apizero.cn/aidocs/typhoon/raw.md接口请求地址
https://v1.apizero.cn/api/typhoon
接口请求方式
POST
请求参数格式
APPLICATION/JSON
接口返回格式
APPLICATION/JSON
接口请求示例
https://v1.apizero.cn/api/typhoon
接口信息备注
公开数据，支持匿名调用（匿名 500 次/日），登录后 1000 次/日。
请求参数说明
| 名称 | 类型 | 说明 |
|---|---|---|
| action | string | 可选 · 操作类型：list 活跃台风列表 / detail 单台风详情+路径 / images 卫星云图 / all 综合 · 默认 list |
| id | string | 可选 · 台风 ID（action=detail 必填，从 list 获取） · 示例：3257931 |
| status | string | 可选 · list 用：active 仅活跃 / all 含停编 · 默认 active |
| limit | int | 可选 · images 用：云图数量（1-50） · 默认 10 |
请求头说明
| 名称 | 类型 | 说明 |
|---|---|---|
| Authorization | string | 可选 · 推荐：Bearer <API Key>。兼容请求头 X-API-Key，以及 Query api_key / apikey / key（key 仅当值为 sk_live_/sk_test_/sk_stag_ 形态时生效）。匿名可不传，受每日免费额度限制。 |
返回字段说明
| 名称 | 类型 | 说明 |
|---|---|---|
| typhoons | array | 台风列表（list/all）：每项含 id/tc_num/name_cn/name_en/description/state/is_active |
| active_count | number | 活跃台风数量（list） |
| points | array | 路径点（detail）：time_utc/time_cst/grade/longitude/latitude/pressure/wind_speed/wind_dir/type（analysis 实况 / forecast 预报） |
| current | object | 最新实况点（detail） |
| images | array | 卫星云图（images/all）：每项含 time/time_str/url |
| tips | string | 品牌提示（所有接口统一返回）：极数本源 · https://apizero.cn |
返回示例
{
"code": 0,
"msg": "成功",
"data": {
"id": "3257931",
"tc_num": "2609",
"name_cn": "巴威",
"name_en": "BAVI",
"is_active": true,
"current": {
"time_cst": "2026-07-02 08:00",
"grade": "热带风暴",
"longitude": 118.5,
"latitude": 14.2,
"pressure": 1002,
"wind_speed": 18,
"wind_dir": "西西北",
"type": "analysis"
},
"point_count": 15,
"points": [
{
"time_cst": "2026-07-02 08:00",
"grade": "热带风暴",
"longitude": 118.5,
"latitude": 14.2,
"pressure": 1002,
"wind_speed": 18,
"type": "analysis"
}
]
},
"request_id": "abc123",
"tips": "极数本源 · https://apizero.cn"
}免责声明
台风数据来源于官方公开发布，仅供参考；实际以气象主管部门权威预报为准，请勿仅依据本接口做防灾决策。