台风最新坐标轨迹接口：5 分钟接入，获取当前台风列表
# 台风最新坐标轨迹接口：5 分钟接入，获取当前台风列表
> 接口 342（apiCode=342）· 免费 · POST/GET · 返回 JSON · 适用：新注册用户、初级开发者 · 阅读约 5 分钟
## 核心要点
- 注册 ShowAPI 账号，在控制台获取 AppKey（密钥仅用于你自己的请求，切勿硬编码进公开仓库）。
- 调用 342-1 当前台风列表，无需任何业务参数，替换 AppKey 即可返回在编台风。
- 业务数据在 showapi_res_body.list，每条含中文名、经纬度、风力等级等 14 个字段。
## Why：这跟我有关系吗
台风季里，第一时间知道「现在有几个台风、在哪、多强」是很多系统的基础需求——气象监测、出行提醒、航运调度都从这一条列表开始。本接口免费，接入成本极低。
## What：接口速览
| 项目 | 说明 |
|------|------|
| 接口/接入点 | 台风最新坐标轨迹接口 · 342-1 当前台风列表 |
| 是否免费 | 是（官方标注「免费服务」） |
| 请求方式 | POST / GET |
| 鉴权 | Query 参数 `appKey` |
| 返回格式 | JSON（业务数据在 `showapi_res_body.list`） |
| 缓存 | 每次查询缓存 6 小时 |
| 集成能力 | MCP、OpenAPI(YAML/JSON) |
## How：一步步调用
### Python（requests）
```python
import requests
resp = requests.post(
"https://route.showapi.com/342-1",
params={"appKey": "YOUR_APPKEY"},
headers={"content-type": "application/x-www-form-urlencoded"},
timeout=10,
)
data = resp.json()
if data.get("showapi_res_code") != 0 or data["showapi_res_body"].get("ret_code") != 0:
raise RuntimeError(data.get("showapi_res_error") or "业务返回非成功")
for t in data["showapi_res_body"]["list"]:
print(f"{t['name']} ({t['enname']}) @ {t['lat']},{t['lng']} {t['strong']}")
```
### cURL
```bash
curl -X POST "https://route.showapi.com/342-1?appKey=YOUR_APPKEY" \
-H "content-type: application/x-www-form-urlencoded"
```
### Node.js（fetch）
```javascript
const r = await fetch("https://route.showapi.com/342-1?appKey=YOUR_APPKEY", {
method: "POST",
headers: { "content-type": "application/x-www-form-urlencoded" },
});
const data = await r.json();
for (const t of data.showapi_res_body.list) {
console.log(`${t.name} (${t.enname}) @ ${t.lat},${t.lng} ${t.strong}`);
}
```
## 返回示例与解析
```json
{
"showapi_res_code": 0,
"showapi_res_error": "",
"showapi_res_id": "ce135f6739294c63be0c021b76b6fbff",
"showapi_res_body": {
"list": [
{
"enname": "Chan-hom", "lat": "26.00", "lng": "125.10",
"movedirection": "北西", "movespeed": "20", "name": "灿鸿",
"power": "16", "pressure": "935", "radius10": "180", "radius7": "450",
"speed": "52", "strong": "超强台风", "tfid": "201509",
"time": "2015-07-10 11:00:00"
},
{
"enname": "Nangka", "lat": "18.30", "lng": "142.70",
"movedirection": "西北西", "movespeed": "10", "name": "浪卡",
"power": "17", "pressure": "920", "radius10": "180", "radius7": "400",
"speed": "60", "strong": "超强台风", "tfid": "201511",
"time": "2015-07-10 08:00:00"
}
],
"ret_code": 0
}
}
```
`showapi_res_code=0` 且 `ret_code=0` 表示成功；`list` 中每条是一个在编台风，`tfid` 是串联 342-2 的钥匙。
## 进阶与边界
免费但每次查询服务端缓存 6 小时，短时间重复查不会拿到更新；`tfid` 是调用 342-2 单个台风详情的必填参数。
## FAQ
**Q：返回里的 showapi_res_code 和 ret_code 有什么区别？**
showapi_res_code 是系统级状态码（0 表示请求成功），ret_code 是业务体内字段（0 表示业务成功）。判断成功应两者都校验。
**Q：接口收费吗？**
本接口为免费服务，官方页明确标注「免费服务」，无档位计费说明。
**Q：为什么两次调用结果一样？**
官方说明每次查询缓存 6 小时，6 小时内相同查询返回缓存结果。
**Q：我能拿到历史台风吗？**
当前列表只返回进行中的台风；历史需调用 342-3 台风历史列表（按年份）。
## 相关能力 / 下一步阅读
- [台风最新坐标轨迹接口返回字段全解：list/obj/typhoon_list 与 14 项坐标强度字段](https://www.showapi.com/guides/typhoon-track-response-fields-342)
- [台风最新坐标轨迹接口：如何调用当前台风列表（342-1）](https://www.showapi.com/guides/typhoon-track-current-list-342)
- [台风最新坐标轨迹接口：6 小时缓存机制下的刷新与去重策略](https://www.showapi.com/guides/typhoon-track-cache-342)
- **本系列共 13 篇**：查看[台风最新坐标轨迹接口官方指南总目录](https://www.showapi.com/guides/typhoon-track-guides-342)
