开发指南

新用户可测试2000次 比某度更精准、及时,请进入气象台网站对比数据

1~40日天气接口-v31


该接口返回最近40日天气, 包含每日日期、农历日期、星期几、天气情况、白天天气、夜间天气、高温低温、日出日落、月出月落、空气质量、湿度等,可按地名、城市编号、LBS、IP查询。
部分字段仅前15日有数据。

地区权限 请求限制 使用方案 发票
全国所有市区县 每日2万次 170/一年(最低) 680/五年(最低) 1326/永久(最低) 可开普票/电子票/专票
全国所有市区县 每日5万次 300/一年(最低) 1200/五年(最低) 2340/永久(最低) 可开普票/电子票/专票
全国所有市区县 每日10万次 550/一年(最低) 2200/五年(最低) 4290/永久(最低) 可开普票/电子票/专票
全国所有市区县 每日20万次 1500/一年(最低) 6000/五年(最低) 11700/永久(最低) 可开普票/电子票/专票
全国所有市区县 每日50万次 4000/一年(最低) 20000/五年(最低) 31200/永久(最低) 可开普票/电子票/专票
全国所有市区县 每日百万~千万次 联系客服开通独享版本,最低9800/年 可开普票/电子票/专票

请求方式及url:

  • 请求方式:GET

  • 接口地址:(请将线路地址设置为动态可修改的)

  • 线路1(推荐)https://v0.yiketianqi.com/api
  • 线路2:https://v1.yiketianqi.com/api
  • 线路3:https://v2.yiketianqi.com/api

请求示例

https://v0.yiketianqi.com/api?version=v31&appid=&appsecret=

请求参数说明:

参数名 必选 类型 说明 备注(示例)
appid string 用户appid 注册开发账号
appsecret string 用户appsecret
version string 接口版本标识 固定值: v31
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 晚上风力风向