开发指南

发布api对接文章到CSDN可联系客服领取10万次请求次数, 感谢您的支持

主要城市AQI列表


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
    }
}