QQ 天气 - 小政API

接口文档

运行状态

运行中

接口类型

免费接口

接口地址

https://api.xzbok.cn/api/qq_weather

返回格式

JSON

请求方式

GET

请求示例

https://api.xzbok.cn/api/qq_weather?city=广州 调用测试

返回示例

{
    "code": 200,
    "msg": "成功",
    "data": {
        "地区": {
            "编码": "101280101",
            "省": "广东",
            "市": "广州"
        },
        "天气": {
            "实况": {
                "气温": "21°",
                "湿度": "100%",
                "现象": "多云",
                "风力": "西南风 3-4级",
                "气压": "1006hPa",
                "更新时间": "2026年03月30日 00:15"
            },
            "预报": [
                {
                    "称呼": "明天",
                    "日期": "2026年03月29日",
                    "低温": "22°",
                    "高温": "27°",
                    "白天": "阴",
                    "夜间": "阵雨",
                    "风力": "北风 1-3级"
                }
            ],
            "空气质量": {
                "空气质量指数": 21,
                "等级": "优",
                "细颗粒物": "14",
                "可吸入颗粒物": "21",
                "二氧化硫": "5",
                "二氧化氮": "30",
                "臭氧": "43",
                "一氧化碳": "0.6"
            },
            "生活指数": [
                {
                    "名称": "穿衣",
                    "摘要": "较舒适",
                    "详情": "建议着薄外套、开衫牛仔衫裤等服装。年老体弱者应适当添加衣物，宜着夹克衫、薄毛衣等。"
                },
                {
                    "名称": "紫外线强度",
                    "摘要": "最弱",
                    "详情": "属弱紫外线辐射天气，无需特别防护。若长期在户外，建议涂擦SPF8-12之间的防晒护肤品。"
                }
            ]
        }
    }
}

错误码参照

系统级错误

状态码	类型	说明
`400`	参数错误	缺少必要参数或参数格式不正确
`401`	未授权	密钥无效或未登录（需登录接口）
`403`	禁止访问	无调用权限或已被封禁
`404`	接口不存在	请求的接口地址有误
`429`	频率限制	请求过于频繁，请稍后重试
`500`	服务器错误	服务异常，请联系管理员

示例代码

调用代码

PHP

$url = "https://api.xzbok.cn/api/qq_weather";
$ch  = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$resp = curl_exec($ch);
curl_close($ch);

echo $resp;

在线调试

请求地址

请求方式

请求参数

返回结果