# 全国城市空气质量查询 · 指南总目录
> 接口一句话速览：ShowAPI **全国城市空气质量查询**（apiCode=104，官方自营 / 生活服务分类）提供全国主要城市的实时空气质量数据，返回 AQI、PM2.5、PM10、SO₂、NO₂、CO、O₃ 等污染物浓度与空气质量等级（优质/良好/轻度污染/中度污染/重度污染/严重污染）。含 2 个接入点：① **104-41 排行榜**（城市空气质量排名列表）；② **104-42 单城市查询**（按城市名返回单条数据）。免费服务（注册即可调用，受免费档位限制）。
> 系列说明：本目录汇总「全国城市空气质量查询」全套官网指南，覆盖从注册接入到行业落地的全链路。所有文章均基于官方接口文档，并经真实请求实测校验。
## 入门层
1. [全国城市空气质量查询：5 分钟接入，拿到第一条空气质量数据](https://www.showapi.com/guides/air-quality-quickstart-104) — 注册、取 AppKey、首次调用与解析，Python/cURL/Node.js 三语言可直接运行。
2. [全国城市空气质量查询：返回字段全解（AQI/PM2.5/质量等级一文读懂）](https://www.showapi.com/guides/air-quality-response-fields-104) — 全部字段对照表 + `ret_code` 说明 + 边界字段（`o3_8h:"_"`、`primary_pollutant:""`）。
3. [全国城市空气质量查询：单城市实时查询集成指南（从请求到 UI 展示）](https://www.showapi.com/guides/air-quality-query-integration-104) — 104-42 接入点，必填 `area` 用法、小地区回退逻辑、前端渲染。
4. [全国城市空气质量查询：城市空气质量排行榜接入与可视化指南](https://www.showapi.com/guides/air-quality-ranking-integration-104) — 104-41 接入点，`list` 数组结构与 Top N 排行榜画法。
5. [全国城市空气质量查询：在微信小程序 / 智能设备中展示空气质量](https://www.showapi.com/guides/air-quality-miniapp-104) — 轻量空气卡片的接入与定时刷新。
## 技术深挖层
6. [全国城市空气质量查询：空气质量等级（优质/良好/污染）判定与配色指南](https://www.showapi.com/guides/air-quality-quality-levels-104) — 6 类等级含义、AQI 与等级映射、前端配色方案。
7. [全国城市空气质量查询：免费额度下如何设计缓存策略节省调用](https://www.showapi.com/guides/air-quality-cache-strategy-104) — 免费仍计额度，用缓存 + 合理 TTL 降频省额度。
## 行业方案层
8. [全国城市空气质量查询：旅游 / 健康类应用的落地方案](https://www.showapi.com/guides/air-quality-travel-health-104) — 出行目的地空气、敏感人群提醒、多城对比。
9. [全国城市空气质量查询：环境监测与智能设备的低成本集成](https://www.showapi.com/guides/air-quality-iot-monitor-104) — 智能音箱/大屏/净化器外接空气卡片的取舍。
## 生态集成层
10. [全国城市空气质量查询：通过 MCP 在 AI 客户端中直接查询](https://www.showapi.com/guides/air-quality-mcp-104) — 基于官方 MCP 配置，在 Cherry Studio / ChatBox 对话式查空气。
11. [全国城市空气质量查询：导入 Postman / Swagger 用 OpenAPI 文档管理接口](https://www.showapi.com/guides/air-quality-openapi-104) — 下载 YAML → 导入 Postman / Swagger UI / Swagger Editor 生成请求模板。
## 相关资源
| 资源 | 链接 |
|------|------|
| 接口详情页（apiCode=104） | https://www.showapi.com/apiGateway/view/104 |
| 接入点 104-41 排行榜 | https://www.showapi.com/apiGateway/view/104/41 |
| 接入点 104-42 单城查询 | https://www.showapi.com/apiGateway/view/104/42 |
| OpenAPI YAML | https://www.showapi.com/openapi/market/104.yaml |
| OpenAPI JSON | https://www.showapi.com/openapi/market/104.json |
| AppKey 管理 | https://www.showapi.com/console#/myApp |
| 免费档位说明 | https://www.showapi.com/free-api |
## 阅读建议
- 第一次接入：从 **第 1 篇（快速开始）** 起步，跑通第一条数据。
- 要做查询/展示功能：读 **第 3、4 篇**（单城查询 / 排行榜）+ **第 6 篇**（等级配色）。
- 免费额度吃紧：必读 **第 7 篇**（缓存策略）。
- 做行业产品：读 **第 8、9 篇**；想接 AI / 做 API 治理：读 **第 10、11 篇**。
