功能介绍
5分钟更新一次，包含基本天气信息、24小时逐小时天气、气象预警、湿度、能见度、气压、日出日落、9大生活指数、pm2.5、pm10、o3、no2、so2、是否需要带口罩、外出适宜、开窗适宜、是否需要打开净化器等，可按地名、城市编号、IP查询。
相比v61增加了：24小时逐小时天气、每小时空气质量、日出日落、白天和晚上天气情况、9大常用生活指数。
API文档在线测试此接口
请求方式及url：
请求方式：
GET
接口地址：(建议在服务端设置线路地址为动态可修改的)
- 线路1(推荐)：
https://v0.yiketianqi.com/api - 线路2：
https://yiketianqi.com/api
请求示例
https://v0.yiketianqi.com/api?version=v62&appid=&appsecret=
请求参数说明：
| 参数名 | 必选 | 类型 | 说明 | 备注（示例） |
|---|---|---|---|---|
| appid | 是 | string | 用户appid | 注册开发账号 |
| appsecret | 是 | string | 用户appsecret | |
| version | 是 | string | 接口版本标识 | 固定值: v62 每个接口的version值都不一样
|
| cityid | 否 | string | 城市ID | 请参考 城市ID列表 |
| city | 否 | string | 城市名称 | 不要带市和区; 如: 青岛、铁西 |
| province | 否 | string | 所在省 | 如果您担心city重名可传此参数, 不要带省和市; 如: 山东、上海 |
| ip | 否 | string | IP地址 | 查询IP所在城市天气 |
| lng | 否 | String | 经度 | 如: 119.545023 (需额外开通lbs权限, 500/年, 2000/5年, 3000/永久) |
| 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":"101020200",
"date":"2020-07-15",
"week":"星期三",
"update_time":"10:17",
"city":"闵行",
"cityEn":"minhang",
"country":"中国",
"countryEn":"China",
"wea":"雨",
"wea_img":"yu",
"tem":"20",
"tem1":"22",
"tem2":"20",
"win":"东风",
"win_speed":"1级",
"win_meter":"小于12km/h",
"humidity":"100%",
"visibility":"2.77km",
"pressure":"1006",
"air":"34",
"air_pm25":"15",
"air_level":"优",
"air_tips":"空气很好，可以外出活动，呼吸新鲜空气，拥抱大自然！",
"alarm":{
"alarm_type":"暴雨",
"alarm_level":"蓝色",
"alarm_content":"闵行区气象局2020年07月15日05时31分发布暴雨蓝色预警[Ⅳ级/一般]：受较强的降水云团影响，预计未来6小时内全区累积降水量将达50毫米以上，请注意防范。（预警信息来源：国家预警信息发布中心）"
},
"wea_day":"大雨",
"wea_day_img":"yu",
"wea_night":"小雨",
"wea_night_img":"yu",
"sunrise":"05:00",
"sunset":"19:00",
"hours":[
{
"hours":"现在",
"wea":"中雨",
"wea_img":"yu",
"tem":"21",
"win":"东风",
"win_speed":"3级",
"aqi":"优"
},
{
"hours":"11:00",
"wea":"中雨",
"wea_img":"yu",
"tem":"21",
"win":"东风",
"win_speed":"3级",
"aqi":"优"
},
{
"hours":"12:00",
"wea":"中雨",
"wea_img":"yu",
"tem":"21",
"win":"东风",
"win_speed":"3级",
"aqi":"优"
},
{
"hours":"13:00",
"wea":"中雨",
"wea_img":"yu",
"tem":"21",
"win":"东北风",
"win_speed":"1级",
"aqi":"优"
},
{
"hours":"14:00",
"wea":"中雨",
"wea_img":"yu",
"tem":"21",
"win":"东北风",
"win_speed":"2级",
"aqi":"优"
},
{
"hours":"15:00",
"wea":"小雨",
"wea_img":"yu",
"tem":"22",
"win":"东北风",
"win_speed":"2级",
"aqi":"优"
},
{
"hours":"16:00",
"wea":"小雨",
"wea_img":"yu",
"tem":"22",
"win":"东北风",
"win_speed":"3级",
"aqi":"优"
},
{
"hours":"17:00",
"wea":"小雨",
"wea_img":"yu",
"tem":"22",
"win":"东风",
"win_speed":"3级",
"aqi":"优"
},
{
"hours":"18:00",
"wea":"中雨",
"wea_img":"yu",
"tem":"22",
"win":"东风",
"win_speed":"2级",
"aqi":"优"
},
{
"hours":"19:00",
"wea":"中雨",
"wea_img":"yu",
"tem":"21",
"win":"东风",
"win_speed":"2级",
"aqi":"优"
},
{
"hours":"20:00",
"wea":"中雨",
"wea_img":"yu",
"tem":"21",
"win":"东风",
"win_speed":"2级",
"aqi":"优"
},
{
"hours":"21:00",
"wea":"小雨",
"wea_img":"yu",
"tem":"21",
"win":"东风",
"win_speed":"2级",
"aqi":"优"
},
{
"hours":"22:00",
"wea":"小雨",
"wea_img":"yu",
"tem":"21",
"win":"东风",
"win_speed":"2级",
"aqi":"优"
},
{
"hours":"23:00",
"wea":"小雨",
"wea_img":"yu",
"tem":"21",
"win":"东风",
"win_speed":"2级",
"aqi":"优"
},
{
"hours":"07/16",
"wea":"多云",
"wea_img":"yun",
"tem":"23",
"win":"东风",
"win_speed":"2级",
"aqi":"优"
},
{
"hours":"01:00",
"wea":"多云",
"wea_img":"yun",
"tem":"23",
"win":"东风",
"win_speed":"2级",
"aqi":"优"
},
{
"hours":"02:00",
"wea":"晴",
"wea_img":"qing",
"tem":"23",
"win":"东北风",
"win_speed":"2级",
"aqi":"优"
},
{
"hours":"03:00",
"wea":"晴",
"wea_img":"qing",
"tem":"23",
"win":"东北风",
"win_speed":"2级",
"aqi":"优"
},
{
"hours":"04:00",
"wea":"多云",
"wea_img":"yun",
"tem":"23",
"win":"东北风",
"win_speed":"2级",
"aqi":"优"
},
{
"hours":"05:00",
"wea":"多云",
"wea_img":"yun",
"tem":"23",
"win":"东风",
"win_speed":"3级",
"aqi":"优"
},
{
"hours":"06:00",
"wea":"小雨",
"wea_img":"yu",
"tem":"23",
"win":"东北风",
"win_speed":"3级",
"aqi":"优"
},
{
"hours":"07:00",
"wea":"小雨",
"wea_img":"yu",
"tem":"23",
"win":"东风",
"win_speed":"3级",
"aqi":"优"
},
{
"hours":"08:00",
"wea":"小雨",
"wea_img":"yu",
"tem":"23",
"win":"东北风",
"win_speed":"3级",
"aqi":"优"
}
],
"aqi":{
"air":"34",
"air_level":"优",
"air_tips":"空气很好，可以外出活动，呼吸新鲜空气，拥抱大自然！",
"pm25":"15",
"pm25_desc":"优",
"pm10":"12",
"pm10_desc":"优",
"o3":"59",
"o3_desc":"优",
"no2":"38",
"no2_desc":"优",
"so2":"3",
"so2_desc":"优",
"co": "1",
"co_desc": "优",
"kouzhao":"无需戴口罩",
"waichu":"适宜外出",
"yundong":"适宜运动",
"kaichuang":"适宜开窗",
"jinghuaqi":"关闭净化器",
},
"zhishu":{
"chuanyi":{
"level":"天气舒适",
"tips":"建议穿长袖牛仔裤等服装。"
},
"daisan":{
"level":"建议带伞",
"tips":"短时外出可以不带伞。"
},
"ganmao":{
"level":"较易发感冒",
"tips":"体质较弱的朋友需注意防护。"
},
"chenlian":{
"level":"不宜晨练",
"tips":"天气条件较不宜晨练。"
},
"ziwaixian":{
"level":"紫外线很弱",
"tips":"您无需担心紫外线。"
},
"liangshai":{
"level":"不适宜晾晒",
"tips":"天气不好，不适宜晾晒。"
},
"kaiche":{
"level":"较适宜开车",
"tips":"天气一般，请小心驾驶。"
},
"xiche":{
"level":"不宜洗车",
"tips":"泥水可能会弄脏您的爱车。"
},
"lvyou":{
"level":"不适宜旅游",
"tips":"天气很差，不适宜旅游。"
},
"diaoyu":{
"level":"不适宜钓鱼",
"tips":"气象条件不利于钓鱼。"
}
}
}
示例代码
$ curl "https://v0.yiketianqi.com/api?version=v62&appid=&appsecret="
错误码参考
| 字段 | 错误码 | 说明 |
|---|---|---|
| errcode | 100 | 该接口有任何异常报错都会返回errcode报错, 并且只有100, 具体报错描述请参考字段：errmsg |
{
"errcode":100,
"errmsg":"缺少注册参数appid或appsecret"
}
