接口信息

GET https://apis.whrx.chat/api/weather/index.php

请求方法

GET

所属分类

生活服务

每分钟限流

不限速

调用次数

1,091

需要密钥

否

需要积分

免费

提交时间

2026-03-08 14:46:49

贡献者

尋鯨錄

接口检测

检测接口是否正常响应

接口反馈

如果接口调用出现问题，请在此反馈（* 联系方式为必填项，建议填写QQ号以便联系）

免责声明

使用本平台接口即表示同意本声明。

1. 数据来源：接口数据来自第三方公开网络或用户上传，本平台不保证准确性、完整性、实时性，请以官方信息为准。
2. 合法性与安全性：本平台无法核实每个接口的安全性、合法性，使用者自行承担相关风险。
3. 用途限制：标注“学习专用”的接口禁止商用；严禁用于违法违规行为（如诈骗、赌博、侵权等）。违规后果由使用者自行承担。
4. 损害免责：使用本接口产生的任何直接或间接损失，本平台不承担责任。
5. 第三方上传：用户/商户上传的接口若侵权或违法，由上传者承担全部责任。
6. 监督配合：本平台依法记录访问日志，如发现违法活动将配合执法部门处理，并有权随时限制或封禁服务。
注:本平台保留最终解释权，并可能随时更新本声明。

请求参数

                            
                                        参数名
                                        类型
                                        必填
                                        描述
                                    
                                        cityId
                                        string
                                        
                                                                                        是
                                                                                    
                                        城市ID编码，如101030100(天津)，需从city.json获取对应城市code
                                    
                                        format
                                        string
                                        
                                                                                        否
                                                                                    
                                        返回格式，默认json，可选xml

[
    {
        "name": "cityId",
        "type": "string",
        "required": true,
        "description": "城市ID编码，如101030100(天津)，需从city.json获取对应城市code",
        "example": ""
    },
    {
        "name": "format",
        "type": "string",
        "required": false,
        "description": "返回格式，默认json，可选xml",
        "example": ""
    }
]

响应示例

{
    "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": "愿你拥有比阳光明媚的心情"
            }
        ]
    }
}

详细文档

# 天气 API 接口文档 ## 接口概述基于公开天气 API 封装的 PHP 代理接口，提供标准 JSON 格式天气数据，支持当前天气、空气质量、未来 5 天预报查询。 ## 接口地址 ``` GET https://api.xunjinlu.fun/api/weather/index.php?cityId={cityId} ``` --- ## 请求参数 | 参数名 | 类型 | 必填 | 说明 | |:---|:---|:---|:---| | `cityId` | string | ✅ 是 | 9 位城市 ID，如 `1010...

# 天气 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生成的文档

请联系管理员生成

在线测试

接口地址

https://apis.whrx.chat/api/weather/index.php

// 请求参数

cityId * - 城市ID编码，如101030100(天津)，需从city.json获取对应城市code

format - 返回格式，默认json，可选xml

响应结果

等待中

// 结果将在此处显示...

获取天气

接口信息

知乎热搜

参数名	类型	必填	描述
cityId	string	是	城市ID编码，如101030100(天津)，需从city.json获取对应城市code
format	string	否	返回格式，默认json，可选xml