天气查询【增强版】
GET
天气
查询城市天气,包含当前天气、空气质量AQI、24小时逐时预报、7天预报、16项生活指数
GET
https://api.tinyaii.cn/v1/weather3
请求参数
| 参数名 | 类型 | 必填 | 说明 | 示例 |
|---|---|---|---|---|
| city | string | 必填 | 城市名称(如:北京、深圳、上海) | — |
返回字段
| 字段 | 类型 | 说明 |
|---|---|---|
| city | string | 城市名称 |
| current | object | 当前天气 |
| current.temp | string | 当前温度(°C) |
| current.weather | string | 天气状况 |
| current.humidity | string | 湿度(%) |
| current.wind | string | 风向 |
| current.wind_level | string | 风力等级 |
| current.pressure | string | 气压(hPa) |
| aqi | object | 空气质量 |
| aqi.value | string | AQI数值 |
| aqi.level | string | 空气质量等级(优/良/轻度污染等) |
| hourly | array | 24小时逐时预报 |
| hourly[].time | string | 时间(如 19:00) |
| hourly[].weather | string | 天气状况 |
| hourly[].temp | string | 温度 |
| hourly[].wind | string | 风向 |
| hourly[].wind_level | string | 风力等级 |
| daily | array | 7天预报 |
| daily[].day | string | 日期名(今天/明天/周X) |
| daily[].date | string | 日期(MM/DD) |
| daily[].day_weather | string | 白天天气 |
| daily[].day_temp | string | 白天温度 |
| daily[].day_wind | string | 白天风向风力 |
| daily[].night_weather | string | 夜间天气 |
| daily[].night_temp | string | 夜间温度 |
| daily[].night_wind | string | 夜间风向风力 |
| indexes | array | 生活指数(16项) |
| indexes[].name | string | 指数名称 |
| indexes[].value | string | 指数值 |
返回示例
{
"code": 200,
"data": {
"city": "北京",
"current": {
"temp": "25",
"weather": "多云",
"humidity": "44",
"wind": "南风",
"wind_level": "4-5级",
"pressure": "1005"
},
"aqi": {
"value": "43",
"level": "优"
},
"hourly": [
{
"time": "19:00",
"weather": "多云",
"temp": "25℃",
"wind": "南风",
"wind_level": "1-3级"
}
],
"daily": [
{
"day": "今天",
"date": "06/21",
"day_weather": "阴",
"day_temp": "29℃",
"day_wind": "西南风 3-4级",
"night_weather": "多云",
"night_temp": "18℃",
"night_wind": "南风 1-3级"
}
],
"indexes": [
{
"name": "空调",
"value": "较少开启"
}
]
}
}
调用示例
curl "https://api.tinyaii.cn/v1/weather3?city=<city>" \
-H "Authorization: Bearer YOUR_API_KEY"const res = await fetch("https://api.tinyaii.cn/v1/weather3?city=<city>", {
headers: { "Authorization": "Bearer YOUR_API_KEY" },
});
console.log(await res.json());import requests
resp = requests.get(
"https://api.tinyaii.cn/v1/weather3",
params={"city": "<city>"},
headers={"Authorization": "Bearer YOUR_API_KEY"},
timeout=10,
)
print(resp.json())把 YOUR_API_KEY 换成你的密钥即可直接运行。密钥只保存在你自己的设备上。