1. 10分钟更新一次,返回全国338个主要城市aqi信息集合,每个城市的AQI详情请使用"城市AQI详情"接口。
2. Aqi值由高到低输出,可做为全国空气质量城市排名使用
3. 开通后,空气质量的3个接口(列表、详情、监测站)均可使用,无需单独购买
地区权限 | 请求限制 | 使用方案 | 发票 | |
---|---|---|---|---|
全国338个主要城市及1734个监测站 | 每日5000次 | 500/一年 | 1500/三年 | 可开电子普票、专票 |
全国338个主要城市及1734个监测站 | 每日1万次 | 600/一年 | 1800/三年 | 可开电子普票、专票 |
全国338个主要城市及1734个监测站 | 每日5万次 | 800/一年 | 3200/三年 | 可开电子普票、专票 |
全国338个主要城市及1734个监测站 | 每日10万次 | 1000/一年 | 3000/三年 | 可开电子普票、专票 |
全国338个主要城市及1734个监测站 | 每日50万次 | 4500/一年 | 13500/三年 | 可开电子普票、专票 |
请求次数限制仅限于单个APPID每日请求次数不超规定范围,并不会限制使用的项目数量、App、设备及IP等。
请求方式及url:
请求方式:GET
接口地址:(请将线路地址设置在服务端, 为动态可修改的, 请勿在C端直连接口, 防止遇到网络问题导致程序异常。)
线路1(推荐):http://ykyaqi.tianqiapi.com
请求示例
http://ykyaqi.tianqiapi.com/?version=alist&citycode=370100&appid=&appsecret=
请求参数说明:
参数名 | 必选 | 类型 | 说明 | 备注(示例) |
---|---|---|---|---|
appid | 是 | string | 用户appid | 注册开发账号 |
appsecret | 是 | string | 用户appsecret | |
version | 是 | string | 接口版本标识 | 固定值: alist 每个接口的version值都不一样
|
citycode | 是 | string | 城市Code | 请参考 城市Code列表 |
备注
暂无。
响应JSON
{ "errcode": 0, "data": { "list": [ // 该列表可做空气质量排名, aqi由高到低 { "citycode": "230800", // 城市code "cityname": "佳木斯市", // 城市名称 "aqi": "500" // 空气质量值 }, { "citycode": "231200", "cityname": "绥化市", "aqi": "500" }, { "citycode": "150300", "cityname": "乌海市", "aqi": "382" }, { "citycode": "230900", "cityname": "七台河市", "aqi": "338" }, { "citycode": "640200", "cityname": "石嘴山市", "aqi": "298" }, { "citycode": "152500", "cityname": "锡林郭勒盟", "aqi": "295" } // 剩余共计338个城市列表 ], "nums": 20, // 接口访问次数 "iscache": 1 } }