获取天气V1

# 天气 API 接口文档 ## 接口概述 基于公开天气 API 封装的 PHP 代理接口，提供标准 JSON 格式天气数据，支持当前天气、空气质量、未来 5 天预报查询。 ## 接口地址 ``` GET https://api.xunjinlu.fun/api/weather/index.php?cityId={cityId} ``` --- ## 请求参数 | 参数名 | 类型 | 必填 | 说明 | |:---|:---|:---|:---| | `cityId` | string | ✅ 是 | 9 位城市 ID，如 `101030100`（天津） | | `format` | string | ❌ 否 | 返回格式，默认 `json` | --- ## 城市 ID 获取 **完整城市列表下载：** `https://api.xunjinlu.fun/api/weather/csid.json` **常用城市 ID：** | 城市 | ID | |:---|:---| | 北京 | 101010100 | | 上海 | 101020100 | | 天津 | 101030100 | | 重庆 | 101040100 | | 广州 | 101280101 | | 深圳 | 101280601 | --- ## 响应参数 ### 基础字段 | 字段 | 类型 | 说明 | |:---|:---|:---| | `code` | int | 状态码 | | `message` | string | 状态描述 | | `time` | string | 响应时间 | | `data` | object | 天气数据 | ### data 对象 | 字段 | 类型 | 说明 | |:---|:---|:---| | `update_time` | string | 系统更新时间 | | `city_info` | object | 城市基本信息 | | `current` | object | 当前实时天气 | | `yesterday` | object | 昨日天气回顾 | | `forecast` | array | 今天 + 未来 4 天预报 | ### city_info 对象 | 字段 | 类型 | 说明 | |:---|:---|:---| | `city` | string | 城市名称 | | `city_id` | string | 城市 ID | | `parent` | string | 上级行政区 | | `weather_update_time` | string | 天气更新时间 | ### current 对象 | 字段 | 类型 | 说明 | |:---|:---|:---| | `date` | string | 日期（YYYYMMDD） | | `temperature` | string | 当前温度（℃） | | `humidity` | string | 相对湿度 | | `pm25` | int | PM2.5 指数 | | `pm10` | int | PM10 指数 | | `quality` | string | 空气质量等级 | | `cold_index` | string | 感冒指数提示 | ### yesterday / forecast 对象 | 字段 | 类型 | 说明 | |:---|:---|:---| | `date` | string | 日期（日） | | `ymd` | string | 年月日 | | `week` | string | 星期 | | `sunrise` | string | 日出时间 | | `sunset` | string | 日落时间 | | `high` | string | 最高温度 | | `low` | string | 最低温度 | | `type` | string | 天气类型 | | `fx` | string | 风向 | | `fl` | string | 风力等级 | | `aqi` | int | 空气质量指数 | | `notice` | string | 天气提示语 | --- ## 错误码 | code | 说明 | |:---|:---| | 200 | 请求成功 | | 400 | 参数错误（缺少 cityId 或格式错误） | | 500 | 服务器错误或上游 API 故障 | --- ## 使用限制 | 限制项 | 说明 | |:---|:---| | 请求间隔 | ≥ 3 秒 | | 每分钟阈值 | 300 次（超过封禁 3600 秒） | | 缓存更新 | 每 8 小时 CDN 缓存更新 | | 建议 | 自行做本地缓存减少 API 调用 | --- ## 调用示例 ### cURL ```bash curl "https://api.xunjinlu.fun/api/weather/index.php?cityId=101030100" ``` PHP ```php ``` JavaScript ```javascript fetch('https://api.xunjinlu.fun/api/weather/index.php?cityId=101030100') .then(res => res.json()) .then(data => { if (data.code === 200) { console.log('当前温度:', data.data.current.temperature); console.log('空气质量:', data.data.current.quality); } }); ```

> 声明：本文档由 AI 根据平台配置自动生成；示例为片段。 ## 接口简介 获取天气接口基于城市ID提供实时天气信息，包括当前温度、湿度、空气质量、PM2.5/PM10数据、感冒指数以及历史和未来天气预报。接口采用CDN缓存机制，每8小时更新一次数据，确保信息时效性。用户可通过指定城市ID获取对应地区的详细天气状况，支持JSON和XML两种返回格式。 ## 请求说明 - **方法**: GET - **请求头**: 无特殊要求 - **地址**: https://api.xunjinlu.fun/api/weather/index.php ## 请求参数表 | 参数名 | 类型 | 必填 | 说明 | |--------|------|------|------| | cityId | string | 是 | 城市ID编码，如101030100(天津) | | format | string | 否 | 返回格式，默认json，可选xml | ## 返回字段表 | 字段名 | 类型 | 说明 | |--------|------|------| | code | int | 状态码，200表示成功 | | message | string | 响应消息 | | time | string | 响应时间 | | data.update_time | string | 数据更新时间 | | data.city_info | object | 城市基本信息 | | data.current | object | 当前天气状况 | | data.yesterday | object | 昨日天气数据 | | data.forecast | array | 未来天气预报数组 | ## 返回示例 ### 成功示例 ```json { "code": 200, "message": "success", "time": "2026-03-08 14:30:25", "data": { "update_time": "2026-03-08 14:30:00", "city_info": { "city": "天津市", "city_id": "101030100", "parent": "天津", "weather_update_time": "14:25" }, "current": { "date": "20260308", "temperature": "24", "humidity": "22%", "pm25": 15, "pm10": 46, "quality": "优", "cold_index": "各类人群可自由活动" }, "yesterday": { "date": "07", "ymd": "2026-03-07", "week": "星期六", "sunrise": "06:30", "high": "高温 25.0℃", "low": "低温 15.0℃", "sunset": "18:15", "aqi": 108, "fx": "西北风", "fl": "4-5级", "type": "晴", "notice": "愿你拥有比阳光明媚的心情" }, "forecast": [ { "date": "08", "ymd": "2026-03-08", "week": "星期日", "sunrise": "06:28", "high": "高温 26.0℃", "low": "低温 16.0℃", "sunset": "18:16", "aqi": 55, "fx": "东南风", "fl": "3-4级", "type": "多云", "notice": "愿你拥有比阳光明媚的心情" } ] } } ``` ### 失败示例 ```json { "code": 400, "message": "cityId参数缺失" } ``` ## 错误码 | 错误码 | 说明 | |--------|------| | 200 | 请求成功 | | 400 | 请求参数错误 | | 401 | 未授权访问 | | 404 | 城市ID不存在 | | 500 | 服务器内部错误 | | 503 | 服务暂时不可用 | ## 调用示例 ### 浏览器直接访问 ``` https://api.xunjinlu.fun/api/weather/index.php?cityId=101030100 ``` ### cURL ```bash curl "https://api.xunjinlu.fun/api/weather/index.php?cityId=101030100" ``` ### Python ```python import requests url = "https://api.xunjinlu.fun/api/weather/index.php" params = {"cityId": "101030100"} response = requests.get(url, params=params) data = response.json() print(data) ``` ### PHP ```php [ 'method' => 'GET', 'header' => 'Content-Type: application/json' ] ]); $response = file_get_contents($url, false, $context); $data = json_decode($response, true); print_r($data); ?> ``` ### HTML ```html ```