稳定、快速、免费的 API 接口服务
天气查询API
接口地址: https://api.suyanw.cn/api/weather.php
返回格式: 请看返回示例
请求方式: GET
请求示例: https://api.suyanw.cn/api/weather.php?city=广州
请求参数说明:
| 名称 | 必填 | 说明 |
|---|---|---|
| city | 是 | 需要查询的地区名 |
| type | 否 | 返回格式,默认json可选text |
系统级错误:
| 名称 | 说明 |
|---|---|
| 400 | 请求错误! |
| 403 | 请求被服务器拒绝! |
| 405 | 客户端请求的方法被禁止! |
| 408 | 请求时间过长! |
| 500 | 服务器内部出现错误! |
| 501 | 服务器不支持请求的功能,无法完成请求! |
| 503 | 系统维护中! |
返回示例:
{
"code": 1,
"text": "获取成功",
"data": {
"city": "广州",
"cityEnglish": "guangzhou",
"temp": "18",
"tempn": "15",
"weather": "多云",
"wind": "微风",
"windSpeed": "<3级",
"time": "2025-12-21 08:00",
"warning": {},
"current": {
"city": "广州",
"cityEnglish": "guangzhou",
"humidity": "100%",
"wind": "西南风",
"windSpeed": "1级",
"visibility": "16km",
"weather": "多云",
"weatherEnglish": "Cloudy",
"temp": "17.6",
"fahrenheit": "63.7",
"air": "36",
"air_pm25": "36",
"date": "12月21日(星期日)",
"time": "06:15",
"image": "http://api.suyanw.cn/api/data/weather/image/云.png"
},
"living": [
{
"name": "穿衣指数",
"index": "舒适",
"tips": "建议穿长袖衬衫单裤等服装。"
},
{
"name": "路况指数",
"index": "干燥",
"tips": "天气较好,路面较干燥,路况较好。"
},
{
"name": "钓鱼指数",
"index": "适宜",
"tips": "适宜垂钓,愿您度过愉快垂钓时光。"
},
{
"name": "晨练指数",
"index": "适宜",
"tips": "天气不错,空气清新。"
},
{
"name": "夜生活指数",
"index": "较适宜",
"tips": "只要您稍作准备就可以放心外出。"
},
{
"name": "感冒指数",
"index": "少发",
"tips": "无明显降温,感冒机率较低。"
},
{
"name": "逛街指数",
"index": "适宜",
"tips": "这种好天气去逛街可使身心畅快放松。"
},
{
"name": "空气污染扩散条件指数",
"index": "中",
"tips": "易感人群应适当减少室外活动。"
},
{
"name": "旅游指数",
"index": "适宜",
"tips": "天气较好,丝毫不会影响您出行的心情。"
},
{
"name": "舒适度指数",
"index": "舒适",
"tips": "白天温度宜人,风力不大。"
},
{
"name": "啤酒指数",
"index": "较适宜",
"tips": "适量的饮用啤酒,注意不要过量。"
},
{
"name": "划船指数",
"index": "适宜",
"tips": "天气较好,适宜划船及嬉玩水上运动。"
},
{
"name": "太阳镜指数",
"index": "很必要",
"tips": "建议佩戴透射比2级且UV400的遮阳镜"
},
{
"name": "紫外线强度指数",
"index": "弱",
"tips": "辐射较弱,涂擦SPF12-15、PA+护肤品。"
},
{
"name": "风寒指数",
"index": "无",
"tips": "温度未达到风寒所需的低温,稍作防寒准备即可。"
},
{
"name": "放风筝指数",
"index": "较适宜",
"tips": "温暖舒适,较适宜放风筝。"
},
{
"name": "空调开启指数",
"index": "较少开启",
"tips": "体感舒适,不需要开启空调。"
},
{
"name": "晾晒指数",
"index": "适宜",
"tips": "天气不错,抓紧时机让衣物晒太阳吧。"
},
{
"name": "洗车指数",
"index": "适宜",
"tips": "天气较好,适合擦洗汽车。"
},
{
"name": "心情指数",
"index": "较好",
"tips": "温度适宜,心情会不错。"
},
{
"name": "中暑指数",
"index": "无中暑风险",
"tips": "天气舒适,对易中暑人群来说非常友善。"
},
{
"name": "交通指数",
"index": "良好",
"tips": "气象条件良好,车辆可以正常行驶。"
},
{
"name": "约会指数",
"index": "较适宜",
"tips": "不用担心天气来调皮捣乱而影响了兴致。"
},
{
"name": "运动指数",
"index": "适宜",
"tips": "天气较好,尽情感受运动的快乐吧。"
},
{
"name": "过敏指数",
"index": "极不易发",
"tips": "无需担心过敏。"
},
{
"name": "美发指数",
"index": "极适宜",
"tips": "好天气将为美发创造健康洁净的环境。"
},
{
"name": "雨伞指数",
"index": "不带伞",
"tips": "天气较好,不用带雨伞。"
},
{
"name": "防晒指数",
"index": "较弱",
"tips": "涂抹12-15SPF,PA+护肤品。"
},
{
"name": "化妆指数",
"index": "去油",
"tips": "请选用露质面霜打底,水质无油粉底霜。"
},
{
"name": "干燥指数",
"index": "适宜",
"tips": "天气条件较好,保持正常对皮肤的护理即可,可使用冬季滋润保湿型护肤品。"
}
]
}
}
错误码格式说明:
| 名称 | 类型 | 说明 |
|---|---|---|
| 无 | 无 | 无 |
调用示例:
无