该接口2小时更新一次,返回最近40日天气, 包含每日日期、农历日期、星期几、天气情况、白天天气、夜间天气、高温低温、日出日落时间、空气质量等,可按地名、城市编号、LBS、IP查询。
地区权限 | 请求限制 | 使用方案 | 发票 | |
---|---|---|---|---|
全国3200个市区县 | 每日10万次 | 365/一年(最低) | 1500/永久(最低) | 可提供普票、电子票、专票 |
全国所有市区县 | 每日百万~千万次 | 联系客服开通独享版本,最低12800/年 | 可开普票/电子票/专票 |
请求方式及url:
请求方式:GET
接口地址:(请将线路地址设置为动态可修改的)
https://v0.yiketianqi.com/api
https://v1.yiketianqi.com/api
https://v2.yiketianqi.com/api
线路4:https://yiketianqi.com/api
请求示例
https://yiketianqi.com/api?version=v3&appid=&appsecret=
请求参数说明:
参数名 | 必选 | 类型 | 说明 | 备注(示例) |
---|---|---|---|---|
appid | 是 | string | 用户appid | 注册开发账号 |
appsecret | 是 | string | 用户appsecret | |
version | 是 | string | 接口版本标识 | 固定值: v2 v3 v2:15日 v3:40日
|
cityid | 否 | string | 城市ID | 请参考 城市ID列表 |
city | 否 | string | 城市名称 | 不要带市和区; 如: 青岛、铁西 |
ip | 否 | string | IP地址 | 查询IP所在城市天气 |
lng | 否 | String | 经度 | 如: 119.545023 (需额外开通lbs权限, 500/年, 2000/5年) |
lat | 否 | String | 纬度 | 如: 36.044254 |
point | 否 | String | 坐标体系 | 默认百度坐标, 如使用高德坐标, 请传参: gaode |
callback | 否 | string | jsonp参数 | 如: jQuery.Callbacks |
vue | 否 | string | 跨域参数 | 如果您使用的是react、vue、angular请填写值: 1 |
备注
cityid、city和ip参数3选一提交,如果不传,默认返回当前ip城市天气,cityid优先级最高。
响应JSON
请点击 在线测试此接口(需要登录) 查看
响应参数说明
参数名 | 类型 | 说明 | 备注 |
---|---|---|---|
cityid | String | 城市ID | |
date | String | 当前日期 | |
week | String | 当前星期 | |
update_time | String | 气象台更新时间 | |
city | String | 城市名称 | |
cityEn | String | 城市英文名称 | |
country | String | 国家名称 | |
countryEn | String | 国家英文名称 | |
data | String | 每日数据列表 | |
┗ date_nl | String | 农历日期 | |
┗ date | String | 当前日期 | |
┗ week | String | 当前星期 | |
┗ wea_c | String | 天气图标ID | |
┗ wea | String | 天气情况 | |
┗ wea_day | String | 白天天气 | |
┗ wea_night | String | 晚间天气 | |
┗ wea_img | String | 天气对应图标 | 固定9种类型(您也可以根据wea字段自己处理): xue、lei、shachen、wu、bingbao、yun、yu、yin、qing |
┗ tem1 | String | 白天温度 | |
┗ tem2 | String | 晚上温度 | |
┗ win_day | String | 白天风力风向 | |
┗ win_night | String | 晚上风力风向 |