1.4 天气（整合笔记·表格版）

一、网页内嵌挂件（博客 / 菜单栏 / 侧边栏 直接用）

方案	调用 / 使用方式	特点	适用场景
心知天气 iframe 挂件	直接嵌入代码，替换城市拼音 html<br><iframe src="https://i.tianqi.com/?c=code&a=getcode&id=6&py=hefei&icon=1" frameborder="0"></iframe><br>	无需 Key、无需后端、零成本、国内稳定、样式简洁	博客菜单栏、网站顶部 / 侧边栏天气预览，静态站点首选
和风天气网页小组件	官网：https://widget.qweather.com/	自定义尺寸 / 样式，官方组件	官网、个人站点美化展示
和风 客户端菜单栏天气	为客户端软件专属功能	无公开 API、无法单独接口调用，仅 APP / 客户端可用	仅本地桌面查看，不能用于网页 / 开发

---

二、各类天气接口 综合对比（开发调用核心）

接口类型	代表服务	费用 / 额度	计费模式 & 安全风险	国内准确度	稳定性	核心优缺点
野生免费公共接口	sojson 天气 http://t.weather.sojson.com/api/weather/city/城市编码	完全免费	无管控、无账单	一般	差，易限流、随时失效	仅适合临时测试，禁止长期使用；需城市编码
无 Key 开源公益接口	[wttr.in](wttr.in)	永久免费、无注册	无 Key、无充值、无欠费、无盗刷风险	一般（国际气象数据，温差 ±1~2℃）	中等，高峰偶尔延迟	开箱即用，支持 JSON；无 AQI、无气象预警
开源可私有化	Open-Meteo	完全免费	无额度限制，支持 Docker 自建	中等	高（可本地部署）	自主可控，规避停服风险
国内轻量首选	高德地图天气 API	个人认证：日 30 万次免费	预充值、余额不足直接停用，无天价账单风险	高（CMA 气象局官方数据）	极高	个人 / 小项目最优；含实况 + 4 天预报
商用全功能	和风天气开发API（QWeather）	每月 5 万次免费，超出按量计费	后付费 + 信用额度，Key 泄露极易产生巨额账单	极高	极高	功能最全，支持实况、小时级预报、7-15天预报、AQI空气质量、气象预警、生活指数；致命坑点：后付费+信用赊账模式，无停机保护，API Key泄露会被恶意刷量，产生天价欠费账单；仅适合商用项目，个人使用不推荐，使用必须配置IP白名单、接口权限、每日调用限额

---

三、补充关键笔记说明

1. 城市编码 sojson 等接口依赖全国城市编码（例：北京 101010100），需自行对照表查询替换。

2. 博客部署最优方案 静态博客 / 无后端场景：优先心知天气 iframe 挂件，一行代码嵌入菜单栏，免开发、免维护。

3. 接口选型规则

• 纯展示、网页挂件 → 优先心知iframe（100%可用）；和风网页组件已失效，废弃不用

• 个人开发、小工具、怕扣费盗刷 → 高德天气 API

• 完全零注册、临时快速调用 → [wttr.in](wttr.in)

• 专业需求（预警、空气质量）→ 和风开发API（谨慎使用，必做安全限流配置，个人不推荐）

• 本地私有化、长期稳定 → Open-Meteo 自建

---

四、留存链接（原笔记汇总）

1. 心知插件主页：https://www.tianqi.com/plugin/list

2. 心知样式配置：https://www.tianqi.com/plugin/styleset?id=6

3. 和风组件（已失效）：https://widget.qweather.com/（新用户无法使用，仅存量老用户可用）

4. SoJson 接口：https://www.sojson.com/api/weather.html

5. 阿里云市场天气：https://market.aliyun.com/products/57096001/cmapi010812.html

6. 城市编码参考：https://blog.csdn.net/qq_40266771/article/details/103906047

和风天气最终总结（核心避坑）：1. 和风Mac客户端菜单栏天气：仅本地桌面使用，无开放API，无法网页嵌入、无法开发调用；2. 和风网页小组件：官网可访问，但新用户Key全部失效，报错undefined，现已废弃，不建议使用；3. 和风开发API：功能最全、数据最准，但计费模式风险极高，个人/小项目坚决不用，商用必须做风控限流。

（注：部分内容可能由 AI 生成）