QQ信息查询V1

# QQ信息查询 API 接口文档 (V1) ## 接口概述 QQ信息查询V1接口是一个综合查询QQ账号信息的API，通过第三方数据源，一次性返回QQ账号的基本资料、头像、会员服务状态及会员详情等信息。支持JSON和TXT两种返回格式，需要密钥验证。 ## 接口地址 ``` GET https://api.xunjinlu.fun/api/qq/v1.php ``` ## 请求方式 - `GET` ## 请求参数 | 参数名 | 类型 | 必填 | 描述 | |--------|------|------|------| | key | string | 是 | 接口访问密钥（开启密钥访问时必填，密钥注册获取） | | qq | string | 是 | 要查询的QQ号码 | | type | string | 否 | 返回数据格式，默认为 `json`，可选值：`json`、`txt` | ### 参数说明 - **key**：接口访问密钥，在 FEER API 平台注册后获取 - **qq**：纯数字QQ号，长度5~11位，首位不为0 - **type**：控制返回格式，传入非 `json` / `txt` 的值时自动修正为 `json` ## 响应参数 ### 成功响应（JSON格式） ```json { "code": 200, "message": "success", "time": "2026-05-22 05:41:37", "data": { "avatar": "https://q.qlogo.cn/g?b=qq&nk=294680648&s=640", "basic_info": { "qq": "294680648", "nickname": "花想容", "level": "LV265级", "icons": "👑👑👑👑🌙🌙⭐", "qid": "4444A", "energy": "16754", "card": "没有设置学院标签", "signature": "彩霞满天，爱意盛在了星河里。", "age": "未设置", "talent_days": "4244天.", "register_time": "2006-01-01 19:24:38", "register_days": "7445天(≈20.4年)", "avatar_update": "2025-01-15 03:46:38", "services": "超级会员8" }, "vip_services": [ { "privilege": "svip", "name": "超级会员", "level": 10 }, { "privilege": "sgreen", "name": "QQ音乐超级会员", "level": 7 }, { "privilege": "bigqqvip", "name": "QQ大会员", "level": 8 }, { "privilege": "syellow", "name": "豪华黄钻", "level": 10 }, { "privilege": "growth", "name": "成长加速包", "level": -1 }, { "privilege": "qqlevel", "name": "等级加速包", "level": -1 } ], "vip_detail": { "iBigClubGrowth": { "value": "44066", "description": "大会员成长值" }, "iNextLevelDay": { "value": "14", "description": "升级剩余天数" }, "iTotalActiveDay": { "value": "30607", "description": "总活跃天数" }, "iVipLevel": { "value": "10", "description": "会员等级" }, "SVIPStar": { "value": "0", "description": "SVIP星级" }, "iBigClubLevel": { "value": "8", "description": "超级会员等级" }, "iBigClubVipFlag": { "value": "1", "description": "年费超级会员标志" } } }, "api_info": { "developer": "尋鯨錄", "blog": "https://www.xunjinlu.fun", "api_platform": "https://api.xunjinlu.fun" } } ``` ### 成功响应（TXT格式） ``` 头像链接：https://q.qlogo.cn/g?b=qq&nk=294680648&s=640 查询账号：294680648 查询昵称：花想容 查询等级：LV265级 查询图标：👑👑👑👑🌙🌙⭐ 查询QID：4444A 查询能量：16754 查询名片：没有设置学院标签 查询签名：彩霞满天，爱意盛在了星河里。 查询年龄：未设置 达人天数：4244天. 注册时间：2006-01-01 19:24:38 注册天数：7445天(≈20.4年) 头像修改：2025-01-15 03:46:38 开通业务：超级会员8 【会员服务】 超级会员：Lv10 QQ音乐超级会员：Lv7 QQ大会员：Lv8 豪华黄钻：Lv10 成长加速包：无等级 等级加速包：无等级 【会员详情】 大会员成长值：44066 升级剩余天数：14 总活跃天数：30607 会员等级：10 SVIP星级：0 超级会员等级：8 年费超级会员标志：1 ``` ### 错误响应 #### 缺少必要参数 ```json { "code": 400, "message": "缺少必要参数：qq", "api_info": { "developer": "尋鯨錄", "blog": "https://www.xunjinlu.fun", "api_platform": "https://api.xunjinlu.fun" } } ``` #### QQ号格式不正确 ```json { "code": 400, "message": "QQ号格式不正确", "api_info": { "developer": "尋鯨錄", "blog": "https://www.xunjinlu.fun", "api_platform": "https://api.xunjinlu.fun" } } ``` #### 上游数据请求失败 ```json { "code": 502, "message": "基本信息接口请求失败", "api_info": { "developer": "尋鯨錄", "blog": "https://www.xunjinlu.fun", "api_platform": "https://api.xunjinlu.fun" } } ``` #### 数据解析失败 ```json { "code": 500, "message": "基本信息接口数据解析失败", "api_info": { "developer": "尋鯨錄", "blog": "https://www.xunjinlu.fun", "api_platform": "https://api.xunjinlu.fun" } } ``` ## 响应字段说明 ### 根字段 | 字段 | 类型 | 说明 | |------|------|------| | code | int | 状态码，200为成功，其他为失败 | | message | string | 状态描述信息 | | time | string | 服务器响应时间 | | data | object/null | 返回的查询数据，失败时无此字段 | | api_info | object | API 开发者信息 | ### data 字段 | 字段 | 类型 | 说明 | |------|------|------| | avatar | string | QQ头像链接（640x640高清） | | basic_info | object | QQ基本信息 | | vip_services | array | 会员服务开通状态列表 | | vip_detail | object | 会员详细信息 | ### basic_info 字段 | 字段 | 类型 | 说明 | |------|------|------| | qq | string | QQ号码 | | nickname | string | QQ昵称 | | level | string | QQ等级 | | icons | string | QQ图标 | | qid | string | QQ唯一标识（QID） | | energy | string | QQ能量值 | | card | string | QQ名片标签 | | signature | string | QQ个性签名 | | age | string | 年龄设置 | | talent_days | string | 达人天数 | | register_time | string | 注册时间 | | register_days | string | 注册天数（含约几年） | | avatar_update | string | 头像最后修改时间 | | services | string | 已开通的业务信息 | ### vip_services 数组元素 | 字段 | 类型 | 说明 | |------|------|------| | privilege | string | 服务标识 | | name | string | 服务名称 | | level | int | 服务等级（-1表示无等级） | ### vip_detail 字段 | 字段 | 类型 | 说明 | |------|------|------| | iBigClubGrowth | object | 大会员成长值 | | iNextLevelDay | object | 升级剩余天数 | | iTotalActiveDay | object | 总活跃天数 | | iVipLevel | object | 会员等级 | | SVIPStar | object | SVIP星级 | | iBigClubLevel | object | 超级会员等级 | | iBigClubVipFlag | object | 年费超级会员标志（1为年费，0为非年费） | > vip_detail 中每个对象包含 `value`（值）和 `description`（中文描述）两个字段。 ### api_info 字段 | 字段 | 类型 | 说明 | |------|------|------| | developer | string | 开发者名称 | | blog | string | 开发者博客地址 | | api_platform | string | API 平台地址 | ## 错误码说明 | 错误码 | 描述 | |--------|------| | 200 | 查询成功 | | 400 | 参数错误（缺少参数或QQ号格式不正确） | | 500 | 数据解析失败 | | 502 | 第三方数据源请求失败 | ## 技术特性 - **多源聚合**：聚合多个第三方数据源，一次请求返回完整的QQ信息 - **双格式输出**：支持 JSON（结构化数据）和 TXT（纯文本）两种返回格式 - **高清头像**：自动生成 640x640 高清QQ头像链接 - **密钥验证**：需要传入有效的接口访问密钥 - **CORS 支持**：已配置跨域访问，支持前端直接调用 ## 注意事项 1. **密钥安全**：请妥善保管接口访问密钥，不要在公开前端代码中暴露 2. **跨域支持**：接口已配置 CORS，支持跨域访问 3. **返回格式**：接口返回 UTF-8 编码的美化 JSON 数据 4. **请求超时**：由于涉及多个第三方数据源聚合，建议客户端设置较长的超时时间 5. **会员数据**：会员服务及详情数据来源于第三方，可能存在延迟，请以QQ官方为准 6. **调用频率**：请合理控制请求频率，避免对第三方数据源造成过大压力 7. **数据仅供参考**：本接口返回的所有数据均来源于第三方，仅供查询参考

> 声明：本文档由 AI 根据平台配置自动生成；示例为片段。 ## 接口简介 QQ信息查询V1接口是一个综合查询QQ账号信息的API，通过聚合多个第三方数据源，一次性返回QQ账号的基本资料、头像、会员服务状态及会员详情等信息。支持JSON和TXT两种返回格式，需要密钥验证。该接口可以帮助开发者快速获取QQ用户的公开信息，适用于用户资料展示、数据分析等场景。 ## 请求说明 - **方法**: GET - **请求头**: 无特殊要求 - **请求地址**: `https://api.xunjinlu.fun/api/qq/v1.php` ## 请求参数表 | 参数名 | 类型 | 必填 | 说明 | |-------|------|------|------| | key | string | 是 | 接口访问密钥（开启密钥访问时必填） | | qq | string | 否 | 查询QQ账号 | | type | string | 否 | 返回数据格式，默认json(json或txt) | ## 返回字段表 | 字段名 | 类型 | 说明 | |-------|------|------| | code | int | 状态码 | | message | string | 返回消息 | | time | string | 查询时间 | | data.avatar | string | 头像链接 | | data.basic_info | object | 基本信息 | | data.vip_services | array | 会员服务列表 | | data.vip_detail | object | 会员详情 | ## 返回示例 ### 成功示例 ```json { "code": 200, "message": "success", "time": "2026-05-22 06:08:42", "data": { "avatar": "https://q.qlogo.cn/g?b=qq&nk=294680648&s=640", "basic_info": { "qq": "294680648", "nickname": "花想容", "level": "LV265级", "icons": "👑👑👑👑🌙🌙⭐", "qid": "4444A", "energy": "16754", "card": "没有设置学院标签", "signature": "彩霞满天，爱意盛在了星河里。", "age": "未设置", "talent_days": "4244天.", "register_time": "2006-01-01 19:24:38", "register_days": "7445天(≈20.4年)", "avatar_update": "2025-01-15 03:46:38" }, "vip_services": [ { "privilege": "svip", "name": "超级会员", "level": 10 }, { "privilege": "sgreen", "name": "QQ音乐超级会员", "level": 9 } ], "vip_detail": { "iBigClubGrowth": { "value": "901703", "description": "大会员成长值" }, "iNextLevelDay": { "value": "452", "description": "升级剩余天数" } } } } ``` ### 失败示例 ```json { "code": 401, "message": "Invalid API key" } ``` ## 错误码 | 错误码 | 说明 | |-------|------| | 200 | 成功 | | 401 | API密钥无效 | | 404 | QQ号不存在 | | 429 | 请求过于频繁 | | 500 | 服务器内部错误 | | 503 | 服务暂时不可用 | ## 调用示例 ### 浏览器直接访问 ``` https://api.xunjinlu.fun/api/qq/v1.php?key=YOUR_KEY&qq=294680648 ``` ### cURL ```bash curl "https://api.xunjinlu.fun/api/qq/v1.php?key=YOUR_KEY&qq=294680648" ``` ### Python ```python import requests url = "https://api.xunjinlu.fun/api/qq/v1.php" params = { "key": "YOUR_KEY", "qq": "294680648" } response = requests.get(url, params=params) print(response.json()) ``` ### PHP ```php "YOUR_KEY", "qq" => "294680648" ]; $context = stream_context_create([ "http" => [ "header" => "Content-Type: application/x-www-form-urlencoded\r\n", "method" => "GET", "content" => http_build_query($params) ] ]); $response = file_get_contents($url, false, $context); echo $response; ?> ``` ### HTML ```html ```