杂项
查询实时天气信息
0次调用
出门前，查一下天气总是个好习惯。这个接口为你提供精准、实时的天气数据。
GET
uapis.cn
/api/v1/misc/weather
查询参数
2
city
string
标准的城市名称，如 '北京', '上海市', '福田区'。请使用官方的省、市、区县行政区划名称。
adcode
string
高德地图的6位数字城市编码。例如，北京市的Adcode是 '110000'。使用Adcode查询更准确、更快速。
功能概述
你可以通过城市名称或高德地图的Adcode来查询指定地区的实时天气状况，包括天气现象、温度、湿度、风向和风力等。
使用须知
- 参数优先级：当你同时提供了
city(城市名) 和adcode(城市编码) 两个参数时，系统会 优先使用adcode进行查询，因为它更精确。 - 查询范围：为了保证查询的准确性，我们的服务仅支持标准的“省”、“市”、“区/县”级别的行政区划名称查询，不保证能查询到乡镇或具体地点。
错误处理指南
- 410 Gone: 这个特殊的错误码意味着你查询的地区无效或不受我们支持。比如你输入了“火星”，或者某个我们无法识别的村庄名称。这个状态码告诉你，这个“资源”是永久性地不可用了。
查询参数
city
string标准的城市名称，如 '北京', '上海市', '福田区'。请使用官方的省、市、区县行政区划名称。
adcode
string高德地图的6位数字城市编码。例如，北京市的Adcode是 '110000'。使用Adcode查询更准确、更快速。
响应
200 / 请求成功
查询成功！返回该地区的实时天气信息。
400 / 错误的请求
请求参数错误。你必须提供 city 或 adcode 参数中的至少一个。
410 / 已删除
查询的地区无效或不受支持。例如，你输入了 '火星' 或某个我们无法识别的村庄名称。这个状态码告诉你，这个“资源”是永久性地不可用了。
500 / 服务器内部错误
服务器内部错误。在处理天气数据时发生了未知问题。
502 / 网关错误
上游服务错误。我们依赖的天气服务提供商（如高德地图）的API暂时不可用或返回了错误。