免费API推荐第一期:想接天气数据,我推和风

QUOTE

想接天气，国内我先推和风。

想给网站、小程序，或者自己撸的小工具接天气，很多人会先搜「免费天气 API」。前几个链接注册一遍，看着顺眼就开调。

后面踩坑也挺固定。国外文档好看，国内网络一抖就超时。有的平台注册很快，字段却少得可怜，页面上最后只剩一个温度。还有的免费额度藏得深，用两天突然要绑卡。

国内天气接口不止一家。我做个人项目会先看和风。这期先过几家常见选择，再把和风从注册打到实时气温。

文档入口：https://dev.qweather.com

封面｜免费API推荐第一期｜和风天气

01

CHOOSE

想接入天气，国内常见几家怎么掂量

高德开放平台的天气，接入省事。页面上只要「晴/雨 + 温度」，够用。湿度、风向、生活指数别指望太多，它本来就偏薄。

心知天气更轻一点，中文文档也好读。免费档能覆盖不少地级市，实况和短期预报做展示页一般够。

彩云天气，强项是分钟级降水。出门要不要带伞这种提醒，它合适。你要是不做短时降水，它未必排第一。

OpenWeather 这类海外源，国际城市往往不错，可服务器在海外。你主要服务国内用户，延迟和稳定性得自己扛。

和风这边，中文文档比较全。实况、预报、空气质量、预警、生活指数、地理查询，基本在同一套服务里。按量计费，天气类数据每个自然月前一段请求免费，个人项目先跑起来压力不大。

我自己的排法：只要基础温度，高德就行；冲着分钟降水看彩云；想资料齐一点、后面还可能加预警或空气质量，优先和风。后文就按和风讲。

怎么选

02

PRICING

和风的「免费」到底指什么

和风现在主流是按量计费。天气预报、预警、空气质量、GeoAPI、天文这些，归在「天气和基础服务」这一组。每个自然月前 5 万次请求，单价是 0 元。超出再按阶梯价。用多少算多少，免费档内就是 0。

个人项目可以先把功能跑起来，控制台里盯请求量。真爆了再降频、加缓存，或者认账付一点钱。

03

PREP

动手前要准备什么

发请求前把这几样备齐：注册账号；建一个项目；加凭据；抄下自己的 API Host；弄清认证怎么带。

凭据有两种：JWT 和 API KEY。官方更推 JWT。API KEY 上手快，练手先用 KEY 没问题，上线再换。Host 从控制台抄自己的就行。

还有一处容易翻车：返回体默认 Gzip。curl 加 --compressed，业务代码按文档解压。不然终端里一堆乱码，你会以为接口坏了。

04

STEPS

接入步骤：从注册到打出气温

1. 建项目、加凭据、抄 Host。KEY 放环境变量，别进公开仓库。

2. 城市搜索换经纬度。实时天气按经纬度走，先查位置：GET .../geo/v2/city/lookup?location=北京，Header 带 X-QW-Api-Key，记下 lat、lon。

3. 打实时天气：GET .../weather/v1/current/{lat}/{lon}，例如 39.92/116.41。路径和字段名看官方「实时天气」文档。

4. curl 先验再写业务。通不通看三样：HTTP 是不是 2xx，业务 code 是不是成功，温度和天气现象有没有值。

接入步骤

05

CURL

可直接改的 curl

Host 和 KEY 换成你的：

...bash

curl --compressed \

-H "X-QW-Api-Key: 你的KEY" \

"https://你的API-Host/geo/v2/city/lookup?location=上海"

...bash

curl --compressed \

-H "X-QW-Api-Key: 你的KEY" \

"https://你的API-Host/weather/v1/current/31.23/121.47"

改用 JWT 的话，Header 换成 Authorization: Bearer 你的Token，路径不用动。

打通了

06

NOTES

我实际接的时候会盯的几件事

密钥放服务端或云函数。浏览器、App 包、小程序源码里硬编码 KEY，等于公开请客。

能缓存就缓存。首页天气十分钟刷一次通常够。用户每滑一下就打接口，又耗免费额度，也没必要。

错误请求刷太猛可能触发风控。重试加间隔，别死循环砸。展示天气时留意开发者许可和署名。预报、预警、空气质量是其他路径，先打通实时天气。

∞