开发指南
开发指南
更新时间：2020-01-20 10:44:09
该接口最快3小时更新一次，包含基本天气信息、气象预警、湿度、能见度、气压、日出日落、每日小时预报、6大生活指数等，可按地名、城市编号、IP查询。
请求方式及url：
请求方式：GET
接口地址：https://tianqiapi.com/api
请求示例
https://tianqiapi.com/api?version=v1&appid=&appsecret=
请求参数说明：
| 参数名 | 必选 | 类型 | 说明 | 备注（示例） |
|---|---|---|---|---|
| appid | 是 | string | 用户appid | 注册开发账号 |
| appsecret | 是 | string | 用户appsecret | |
| version | 是 | string | 接口版本标识 | 固定值: v1 每个接口的version值都不一样
|
| cityid | 否 | string | 城市ID | 请参考 城市ID列表 |
| city | 否 | string | 城市名称 | 不要带市和区; 如: 青岛、铁西 |
| ip | 否 | string | IP地址 | 查询IP所在城市天气 |
| callback | 否 | string | jsonp参数 | 如: jQuery.Callbacks |
| vue | 否 | string | 跨域参数 | 如果您使用的是react、vue、angular请填写值: 1 |
备注
cityid、city和ip参数3选一提交，如果不传，默认返回当前ip城市天气，cityid优先级最高。
响应JSON
请点击 在线测试此接口(需要登录) 查看
响应参数说明
| 参数名 | 类型 | 说明 | 备注 |
|---|---|---|---|
| cityid | String | 城市ID | |
| update_time | String | 气象台更新时间 | |
| city | String | 城市名称 | |
| cityEn | String | 城市英文名称 | |
| country | String | 国家名称 | |
| countryEn | String | 国家英文名称 | |
| data | String | 每日数据列表 | 1-7日，共7组 |
| ┗ wea | String | 天气情况 | |
| ┗ wea_img | String | 天气对应图标 | 固定9种类型(您也可以根据wea字段自己处理): xue、lei、shachen、wu、bingbao、yun、yu、yin、qing |
| ┗ tem | String | 实时温度 | |
| ┗ tem1 | String | 高温 | |
| ┗ tem2 | String | 低温 | |
| ┗ win | String | 风向 | |
| ┗ win_speed | String | 风力等级 | |
| ┗ humidity | String | 湿度 | |
| ┗ sunrise | String | 日出 | 例如：06:30 |
| ┗ sunset | String | 日出 | 例如：17:30 |
| ┗ visibility | String | 能见度 | |
| ┗ pressure | String | 气压hPa | |
| ┗ air | String | 空气质量 | |
| ┗ air_level | String | 空气质量等级 | |
| ┗ air_tips | String | 空气质量描述 | |
| ┗ alarm | String | 气象预警 | |
| ┗ alarm_type | String | 预警类型 | |
| ┗ alarm_level | String | 预警级别 | |
| ┗ alarm_level | String | 预警详细信息 | |
| ┗ hours | String | 小时预报 | |
| ┗ hours | String | 时间点 | 例如：20时 |
| ┗ wea | String | 天气 | |
| ┗ wea_img | String | 天气图标 | |
| ┗ tem | String | 温度 | |
| ┗ win | String | 风向 | |
| ┗ win_speed | String | 风力等级 | |
| ┗ index | String | 生活指数 | |
| ┗ title | String | 指数类型 | 例如：穿衣指数 |
| ┗ level | String | 级别 | 例如：较冷 |
| ┗ desc | String | 描述 | 例如：建议着棉衣加羊毛衫等冬季服装。 |
| ┗ aqi | String | 空气质量指数 | |
| ┗ air | String | 空气质量 | |
| ┗ air_level | String | 空气质量等级 | |
| ┗ air_tips | String | 空气质量提示 | |
| ┗ pm25 | String | PM2.5 | |
| ┗ pm25_desc | String | PM2.5等级描述 | |
| ┗ pm10 | String | PM10 | |
| ┗ pm10_desc | String | PM10等级描述 | |
| ┗ o3 | String | o3 | |
| ┗ o3_desc | String | o3等级描述 | |
| ┗ no2 | String | no2 | |
| ┗ no2_desc | String | no2等级描述 | |
| ┗ so2 | String | so2 | |
| ┗ so2_desc | String | so2等级描述 | |
| ┗ kouzhao | String | 是否需要带口罩 | |
| ┗ waichu | String | 外出适宜 | |
| ┗ kaichuang | String | 开窗适宜 | |
| ┗ jinghuaqi | String | 是否需要打开净化器 |
免费实况天气API