功能介绍
该接口2小时更新一次，支持全球6000多个城市和地区，返回最近7日天气，包含基本天气信息、每日小时天气，可按地名、城市编号、IP查询。
API文档在线测试此接口
请求方式及url：
请求方式：
GET
接口地址：(建议在服务端设置线路地址为动态可修改的)
- 线路1：
https://yiketianqi.com/api
请求示例
https://yiketianqi.com/api?version=v5&appid=&appsecret=&city=堪培拉
请求参数说明：
| 参数名 | 必选 | 类型 | 说明 | 备注（示例） |
|---|---|---|---|---|
| appid | 是 | string | 用户appid | 注册开发账号 |
| appsecret | 是 | string | 用户appsecret | |
| version | 是 | string | 接口版本标识 | 固定值: v5 |
| 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优先级最高。
响应字段说明
| 参数名 | 类型 | 说明 | 备注 |
|---|---|---|---|
| cityid | String | 城市ID | |
| update_time | String | 气象台更新时间 | |
| city | String | 城市名称 | 例如：纽约 |
| cityEn | String | 城市英文名称 | 例如：New York |
| country | String | 国家名称 | 例如：美国 |
| countryEn | String | 国家英文名称 | 例如：United States |
| data | String | 每日数据列表 | |
| ┗ date | String | 当前日期 | |
| ┗ wea | String | 天气情况 | 例如：晴 |
| ┗ wea_img | String | 天气对应图标 | 固定9种类型(您也可以根据wea字段自己处理): xue、lei、shachen、wu、bingbao、yun、yu、yin、qing |
| ┗ tem1 | String | 白天温度 | 例如：18 |
| ┗ tem2 | String | 晚上温度 | 例如：-5 |
| ┗ win | String | 风向 | 例如：北风 |
| ┗ win_speed | String | 风力 | 例如：3-4级 |
| ┗ hours | String | 小时预报 | |
| ┗ hours | String | 时间点 | 例如：20时 |
| ┗ wea | String | 天气 | |
| ┗ wea_img | String | 天气图标 | |
| ┗ tem | String | 温度 | |
| ┗ win | String | 风向 | |
| ┗ win_speed | String | 风力等级 |
响应JSON
{
"cityid":"601020101",
"city":"悉尼", #城市名称
"cityEn":"Sydney", #城市英文
"country":"澳大利亚", #国家
"countryEn":"Australia", #国家英文
"update_time":"2020-07-21 15:54:20", #更新时间
"data":[ #每日数据列表, 共7组
{
"date":"2020-07-21", #日期
"wea":"小雨转多云", #天气情况
"wea_img":"yun", #天气情况图标
"tem1":"15", #白天温度(高温)
"tem2":"10", #夜间温度(低温)
"win":[
"西南风", #白天风向
"西南风" #夜间风向
],
"win_speed":"6-7级转<3级", #风力
"hours":[ #小时天气列表
{
"hours":"21日07时",
"wea":"多云",
"wea_img":"yun",
"tem":"9",
"win":"西南风",
"win_speed":"3-4级"
},
{
"hours":"21日10时",
"wea":"多云",
"wea_img":"yun",
"tem":"14",
"win":"西南风",
"win_speed":"6-7级"
},
{
"hours":"21日13时",
"wea":"小雨",
"wea_img":"yu",
"tem":"15",
"win":"西南风",
"win_speed":"3-4级"
},
{
"hours":"21日16时",
"wea":"小雨",
"wea_img":"yu",
"tem":"14",
"win":"西南风",
"win_speed":"3-4级"
},
{
"hours":"21日19时",
"wea":"晴",
"wea_img":"qing",
"tem":"13",
"win":"南风",
"win_speed":"<3级"
},
{
"hours":"21日22时",
"wea":"晴",
"wea_img":"qing",
"tem":"12",
"win":"西南风",
"win_speed":"<3级"
},
{
"hours":"22日01时",
"wea":"多云",
"wea_img":"yun",
"tem":"11",
"win":"西南风",
"win_speed":"<3级"
},
{
"hours":"22日04时",
"wea":"晴",
"wea_img":"qing",
"tem":"10",
"win":"西南风",
"win_speed":"<3级"
}
]
},
{
"date":"2020-07-22",
"wea":"多云转小雨",
"wea_img":"yun",
"tem1":"15",
"tem2":"9",
"win":[
"西南风",
"南风"
],
"win_speed":"<3级",
"hours":[
{
"hours":"22日07时",
"wea":"晴",
"wea_img":"qing",
"tem":"10",
"win":"西南风",
"win_speed":"<3级"
},
{
"hours":"22日10时",
"wea":"多云",
"wea_img":"yun",
"tem":"13",
"win":"西南风",
"win_speed":"<3级"
},
{
"hours":"22日13时",
"wea":"多云",
"wea_img":"yun",
"tem":"15",
"win":"西南风",
"win_speed":"<3级"
},
{
"hours":"22日16时",
"wea":"晴",
"wea_img":"qing",
"tem":"15",
"win":"东风",
"win_speed":"<3级"
},
{
"hours":"22日19时",
"wea":"晴",
"wea_img":"qing",
"tem":"13",
"win":"东北风",
"win_speed":"<3级"
},
{
"hours":"22日22时",
"wea":"多云",
"wea_img":"yun",
"tem":"12",
"win":"南风",
"win_speed":"<3级"
},
{
"hours":"23日01时",
"wea":"小雨",
"wea_img":"yu",
"tem":"10",
"win":"南风",
"win_speed":"<3级"
},
{
"hours":"23日04时",
"wea":"小雨",
"wea_img":"yu",
"tem":"9",
"win":"南风",
"win_speed":"<3级"
}
]
},
{
"date":"2020-07-23",
"wea":"小雨",
"wea_img":"yu",
"tem1":"14",
"tem2":"8",
"win":[
"东北风",
"北风"
],
"win_speed":"<3级",
"hours":[
{
"hours":"23日07时",
"wea":"小雨",
"wea_img":"yu",
"tem":"10",
"win":"南风",
"win_speed":"<3级"
},
{
"hours":"23日10时",
"wea":"小雨",
"wea_img":"yu",
"tem":"13",
"win":"西南风",
"win_speed":"<3级"
},
{
"hours":"23日13时",
"wea":"小雨",
"wea_img":"yu",
"tem":"14",
"win":"东南风",
"win_speed":"<3级"
},
{
"hours":"23日16时",
"wea":"小雨",
"wea_img":"yu",
"tem":"14",
"win":"东风",
"win_speed":"<3级"
},
{
"hours":"23日19时",
"wea":"多云",
"wea_img":"yun",
"tem":"13",
"win":"东北风",
"win_speed":"<3级"
},
{
"hours":"23日22时",
"wea":"小雨",
"wea_img":"yu",
"tem":"12",
"win":"东北风",
"win_speed":"<3级"
},
{
"hours":"24日01时",
"wea":"小雨",
"wea_img":"yu",
"tem":"10",
"win":"北风",
"win_speed":"<3级"
},
{
"hours":"24日04时",
"wea":"小雨",
"wea_img":"yu",
"tem":"9",
"win":"北风",
"win_speed":"<3级"
}
]
},
{
"date":"2020-07-24",
"wea":"小雨",
"wea_img":"yu",
"tem1":"17",
"tem2":"8",
"win":[
"北风",
"北风"
],
"win_speed":"<3级",
"hours":[
{
"hours":"24日07时",
"wea":"小雨",
"wea_img":"yu",
"tem":"9",
"win":"西北风",
"win_speed":"<3级"
},
{
"hours":"24日10时",
"wea":"小雨",
"wea_img":"yu",
"tem":"14",
"win":"西北风",
"win_speed":"<3级"
},
{
"hours":"24日16时",
"wea":"晴",
"wea_img":"qing",
"tem":"16",
"win":"东北风",
"win_speed":"<3级"
},
{
"hours":"24日22时",
"wea":"小雨",
"wea_img":"yu",
"tem":"13",
"win":"北风",
"win_speed":"<3级"
},
{
"hours":"25日04时",
"wea":"小雨",
"wea_img":"yu",
"tem":"9",
"win":"北风",
"win_speed":"<3级"
}
]
},
{
"date":"2020-07-25",
"wea":"小雨",
"wea_img":"yu",
"tem1":"18",
"tem2":"9",
"win":[
"东北风",
"东风"
],
"win_speed":"<3级转3-4级",
"hours":[
{
"hours":"25日10时",
"wea":"小雨",
"wea_img":"yu",
"tem":"13",
"win":"北风",
"win_speed":"<3级"
},
{
"hours":"25日16时",
"wea":"小雨",
"wea_img":"yu",
"tem":"18",
"win":"东北风",
"win_speed":"<3级"
},
{
"hours":"25日22时",
"wea":"小雨",
"wea_img":"yu",
"tem":"13",
"win":"东风",
"win_speed":"<3级"
},
{
"hours":"26日04时",
"wea":"小雨",
"wea_img":"yu",
"tem":"10",
"win":"东南风",
"win_speed":"<3级"
}
]
},
{
"date":"2020-07-26",
"wea":"小雨转中雨",
"wea_img":"yu",
"tem1":"17",
"tem2":"12",
"win":[
"东南风",
"西南风"
],
"win_speed":"3-4级转6-7级",
"hours":[
{
"hours":"26日10时",
"wea":"中雨",
"wea_img":"yu",
"tem":"12",
"win":"东风",
"win_speed":"3-4级"
},
{
"hours":"26日16时",
"wea":"小雨",
"wea_img":"yu",
"tem":"17",
"win":"东南风",
"win_speed":"3-4级"
},
{
"hours":"26日22时",
"wea":"小雨",
"wea_img":"yu",
"tem":"15",
"win":"东南风",
"win_speed":"3-4级"
},
{
"hours":"27日04时",
"wea":"中雨",
"wea_img":"yu",
"tem":"13",
"win":"南风",
"win_speed":"5-6级"
}
]
},
{
"date":"2020-07-27",
"wea":"小雨",
"wea_img":"yu",
"tem1":"18",
"tem2":"10",
"win":[
"西南风",
"西风"
],
"win_speed":"5-6级转4-5级",
"hours":[
{
"hours":"27日10时",
"wea":"中雨",
"wea_img":"yu",
"tem":"16",
"win":"西南风",
"win_speed":"6-7级"
},
{
"hours":"27日16时",
"wea":"中雨",
"wea_img":"yu",
"tem":"16",
"win":"西南风",
"win_speed":"5-6级"
},
{
"hours":"27日22时",
"wea":"小雨",
"wea_img":"yu",
"tem":"13",
"win":"西南风",
"win_speed":"5-6级"
},
{
"hours":"28日04时",
"wea":"小雨",
"wea_img":"yu",
"tem":"10",
"win":"西风",
"win_speed":"4-5级"
}
]
}
]
}
示例代码
$ curl "https://yiketianqi.com/api?version=v5&appid=&appsecret=&city=堪培拉"
错误码参考
| 字段 | 错误码 | 说明 |
|---|---|---|
| errcode | 100 | 该接口有任何异常报错都会返回errcode报错, 并且只有100, 具体报错描述请参考字段：errmsg |
{
"errcode":100,
"errmsg":"缺少注册参数appid或appsecret"
}
