AQICN

简介

AQICN 是 天气 分类下的免费公共 API。1000 多个城市的空气质量指数数据。

天气类 API 是免费开发者工具中的常青树——常用于仪表盘、出行规划、家居自动化和物联网项目。

该 API 可用于原型、个人项目和正式产品，使用时请遵守服务商的使用政策。

认证方式

AQICN 使用 API 密钥 认证，调用前需要先获取密钥：

1. 打开下方官方文档。
2. 找到注册 / API 密钥相关入口并创建账号。
3. 复制密钥，并按文档说明在每次请求中携带（请求头或查询参数）。

请将密钥保存在服务端，切勿提交到公开仓库。

HTTPS 与 CORS

• HTTPS：支持——与 AQICN 的通信经过加密，可用于生产环境。
• CORS：未知——如需浏览器直接调用，请先在官方文档确认或发一个测试请求验证。

快速开始

1. 查阅官方文档：https://aqicn.org/api/
2. 获取 API 密钥（见上方「认证方式」）。
3. 用 curl 或你常用的 HTTP 客户端按文档发送测试请求。

速率限制与注意事项

• 速率限制、配额与免费额度由服务商定义——扩展前请查阅 AQICN 官方文档。
• 上游列表由社区维护；认证方式、HTTPS 与 CORS 字段为收录时的状态，可能发生变化。

常见问题

如何获取 AQICN 的 API 密钥？

密钥由服务商发放，请前往官方文档（https://aqicn.org/api/）按注册 / 密钥指引操作。