和风天气API接入教程与实时天气查询技巧

最近帮朋友的小站点加一个实时天气模块，折腾了一圈和风天气API，从注册到调通接口前后花了小半天时间。网上不少教程写得太官方，照着做还是会卡在几个细节上，所以我把自己的接入过程和查询技巧整理出来，给同样想用和风天气做天气展示的朋友省点时间。不管你是做个人博客、本地资讯站还是小程序，只要需要实时天气查询功能，这篇应该都能对上号。

先搞清楚和风天气API的免费额度与Key申请

很多人第一步就懵了，打开和风天气官网发现版本挺多。我的建议是先用免费开发版练手，个人站点日常调用完全够用。注册账号后进控制台，创建一个项目，然后添加Key。这里注意，和风天气的Key分Web API和Android SDK等不同类型，网页端调用就选Web API那个。创建完记得把Key复制到本地记事本，页面关掉后再找有点麻烦。还有个细节，新账号默认有调用次数限制，自己测试时别写死循环去刷接口，不然容易被临时限流，我第一天就干过这事，排查半天以为是代码问题。

接口地址别拼错，实时天气查询就这几个参数

和风天气的实时天气接口地址结构不复杂，核心是带上location和key两个参数。location可以填城市名，也可以填LocationID，后者更稳。我一开始图省事直接传中文城市名，大部分情况能返回，但偶尔遇到生僻地名就查不到，后来换成和风天气提供的城市搜索接口先拿ID，再查天气，成功率明显上去了。返回的JSON里字段挺全，温度、湿度、风向、气压都有，做实时天气查询展示时挑常用的几个渲染就行。另外提醒一句，请求头里记得设好编码，不然中文城市名容易出乱码。

接入过程中容易踩的几个坑

第一个坑是跨域。前端直接调和风天气接口大概率会被浏览器拦，稳妥做法是后端转发一层，或者用他们提供的服务端调用方式。第二个坑是Key写在前端代码里，公开仓库一传就泄露，建议放环境变量。第三个坑是缓存，天气数据没必要每次都实时拉，我一般设十分钟缓存，既省调用次数，页面打开也快。还有个小经验，调试时先用浏览器直接访问拼好的接口地址，看看返回内容再写代码，比在控制台里盲猜快多了。这套流程走下来，实时天气查询功能基本就稳了。

最后说下查询技巧，和风天气支持按经纬度查，做定位类页面时比城市名更准。另外他们文档里有个错误码对照表，遇到返回码不对先查表，别急着改代码。整体用下来，和风天气的文档还算清楚，接口响应也快，适合拿来练手或者给站点加个实用的天气小模块。按上面步骤走一遍，实时天气查询接入基本不会再卡壳。