中国天气

> 声明：本文档由 AI 根据平台配置自动生成；示例为片段。 # 中国天气 API ## 接口简介 中国天气 API 提供全国各城市的天气查询服务，数据来源于中国天气网。通过该接口，用户可以获取指定城市的实时天气状况、空气质量信息以及未来几天的天气预报。接口采用 GET 方法，返回 JSON 格式的数据，便于开发者集成到各类应用中。支持全国主要城市查询，数据更新及时准确。 ## 请求说明 - **方法**：GET - **请求头**：Content-Type: application/json - **请求地址**：`https://api.xunjinlu.fun/apis/zgtq` ## 请求参数 | 参数名 | 类型 | 必填 | 说明 | |-------|------|------|------| | city | string | 是 | 城市名称 | ## 返回字段表 | 字段名 | 类型 | 说明 | |-------|------|------| | code | number | 状态码 | | message | string | 返回信息 | | timestamp | number | 时间戳 | | data.location.name | string | 城市名称 | | data.location.province | string | 省份名称 | | data.location.city | string | 城市名称 | | data.current.update_time | string | 更新时间 | | data.current.weather | string | 天气状况 | | data.current.temperature | string | 温度 | | data.current.humidity | string | 湿度 | | data.current.wind | string | 风向 | | data.current.wind_level | string | 风力等级 | | data.current.air_quality | string | 空气质量 | | data.current.aqi | string | AQI指数 | | data.forecast | array | 天气预报数组 | ## 返回示例 ### 成功示例 ```json { "code": 200, "message": "success", "timestamp": 1776424547, "data": { "location": { "name": "南宁市", "province": "广西壮族自治区", "city": "南宁市" }, "current": { "update_time": "19:00", "weather": "多云", "temperature": "22", "humidity": "89%", "wind": "东风", "wind_level": "1级", "air_quality": "优", "aqi": "25" }, "forecast": [ { "date": "04.17", "day_weather": "大雨", "high_temp": "24", "low_temp": "20", "wind": "西北风", "wind_level": "3-4级" }, { "date": "04.18", "day_weather": "多云", "high_temp": "30", "low_temp": "21", "wind": "东风", "wind_level": "<3级" } ] } } ``` ### 失败示例 ```json { "code": 400, "message": "城市名称不能为空" } ``` ## 错误码 | 错误码 | 说明 | |-------|------| | 200 | 请求成功 | | 400 | 请求参数错误 | | 404 | 城市不存在 | | 500 | 服务器内部错误 | | 503 | 服务暂时不可用 | ## 调用示例 ### 浏览器直接访问 ``` https://api.xunjinlu.fun/apis/zgtq?city=北京市 ``` ### cURL ```bash curl "https://api.xunjinlu.fun/apis/zgtq?city=上海市" ``` ### Python ```python import requests url = "https://api.xunjinlu.fun/apis/zgtq" params = {"city": "广州市"} response = requests.get(url, params=params) data = response.json() print(data) ``` ### PHP ```php ``` ### HTML ```html ```