空气质量排行

免费

按空气质量或污染物给监测站排序。

稳定可用
免费
空气排行
污染物
城市

¥0.00/次

免费调用 · 匿名不可用

价格为设计演示，不是正式销售报价。

开通人数0
累计调用次数0
成功率0%
会员额度黄金每天 1 万次铂金每天 3.6 万次钻石每天 8 万次当日有效。

接口概述

可按空气质量指数、细颗粒物、粗颗粒物、臭氧、一氧化碳、二氧化氮、二氧化硫排序。

快速查询毫秒级响应
数据准确结构化返回
多类型支持生活服务
稳定可靠高可用服务

这次会返回

request_id这次调用的编号。排错时把这一串和投诉邮箱一起发过来
notice结果仅供参考，不作为专业判断依据。请自行核实后再使用。
contact投诉邮箱 complaint@yibudo.com。对结果有异议写到这个地址，并带上请求编号
code业务状态码，200 表示成功
message提示信息

响应示例98 ms

{
  "code": 200,
  "message": "ok",
  "data": {
    "item1": "示例",
    "item2": "示例",
    "item3": "示例"
  }
}

怎么调用

请求地址

https://api.yibudo.com/v1/air/ranking

请求方式

GET （推荐）

返回格式

JSON

认证方式

Bearer Token。须先登录并开通本接口，匿名不可调用

计费说明

买断套餐

档位	次数	单价	合计
基础套餐	10,000 次	¥0.00080/次	¥8.00
进阶套餐	50,000 次	¥0.00060/次	¥30.00
大额套餐	200,000 次	¥0.00045/次	¥90.00

一次买断。基础套餐 ¥8.00。超额按次 ¥0.00150。

请求频率

项目	额度
登录用户	每月 500 次
黄金会员	每天 10,000 次，每秒 5 次
铂金会员	每天 36,000 次，每秒 20 次
钻石会员	每天 80,000 次，每秒 40 次

预报、语音、台风、雷达、闪电、空气共用。与已购套餐分别计算。

请求参数

参数为设计演示。

参数名	类型	必填	示例值	说明
by	string	否	aqi	固定填 aqi
order	string	否	low	low 从低到高，high 从高到低
limit	string	否	20	按 aqi 填写 limit，例如 20

怎么填

当前是 aqi。照着下面几行填。

by选填固定填 aqi
order选填low 从低到高，high 从高到低
limit选填按 aqi 填写 limit，例如 20

请求示例

GEThttps://api.yibudo.com/v1/air/ranking?by=aqi&limit=20&order=low

响应字段

返回内容为设计演示。点开对象或数组，里面的字段连在它下面。完整字段默认折在表格下面。

字段	类型	说明
`request_id`	string	这次调用的编号。排错时把这一串和投诉邮箱一起发过来
`notice`	string	结果仅供参考，不作为专业判断依据。请自行核实后再使用。
`contact`	string	投诉邮箱 complaint@yibudo.com。对结果有异议写到这个地址，并带上请求编号
`code`	integer	业务状态码，200 表示成功
`message`	string	提示信息
	object	里面的字段
`item1`	string	排名
`item2`	string	空气指数
`item3`	string	主要污染物

错误码

状态码	说明
200	成功
400	参数缺失或格式不正确
401	未登录、未开通，或无法识别 Authorization
404	未查询到记录
429	调用过于频繁

代码示例

curl -G "https://api.yibudo.com/v1/air/ranking" \
  -H "Authorization: Bearer <token>" \
  --data-urlencode "by=aqi&order=low&limit=20"

const url = new URL("https://api.yibudo.com/v1/air/ranking");
url.search = "by=aqi&order=low&limit=20";
const res = await fetch(url, {
  headers: { Authorization: "Bearer <token>" }
});
const data = await res.json();

import requests

res = requests.get(
    "https://api.yibudo.com/v1/air/ranking",
    params={"by": "aqi", "order": "low", "limit": "20"},
    headers={"Authorization": "Bearer <token>"},
)
print(res.json())

SDK 下载

安装包按下面的说明获取。没有包时，先用代码示例里的 HTTP 调用。

Pythonpip 包未发布
JavaScriptnpm 包未发布
JavaMaven 包未发布
Go模块未发布

在线调试

本接口需登录并开通后才能调用，匿名不可用。点运行后，参数会加密发到本站；未登录直接拒绝，不会发起真实查询。

GEThttps://api.yibudo.com/v1/air/ranking

byaqi - 空气指数 / fine - 细颗粒物 / coarse - 粗颗粒物 / ozone - 臭氧 / monoxide - 一氧化碳 / nitrogen - 二氧化氮 / sulfur - 二氧化硫

orderlow - 从低到高 / high - 从高到低

从低到高low从高到低high

limit可不填，默认 20

登录后选择已有密钥才能运行。去登录

返回内容

选择密钥并运行后，返回内容显示在这里。

常见问题

这个页面会发起真实查询吗？

不会发起真实查询。运行调试只把密封后的参数发到本站，未登录时直接拒绝。价格和返回仍是设计演示，不是正式销售报价。

怎么看请求参数？

by: aqi / fine / coarse / ozone / monoxide / nitrogen / sulfur · order: low / high · limit (条数，1 到 200)

没有登录可以调用吗？

不可以。本接口需要登录并开通后才能调用，匿名访问不可用。开通人数和调用次数是设计演示，点击开通不会创建订单，也不会发出真实请求。