获取 QQ 账号的全维度等级信息,包含 QQ 等级、总活跃天数、升级剩余天数、PC 端在线时长,以及 QQ 会员(等级、年标、成长值、到期时间、图标)、QQ 音乐绿钻(绿钻等级、年标状态、成长值)等核心权益信息。
| 参数名 | 类型 | 必填 | 说明 | 示例 |
|---|---|---|---|---|
| string | 是 | 需要查询的QQ号,如:1828222534 | 1828222534 |
[
{
"name": "qq",
"type": "string",
"required": true,
"description": "需要查询的QQ号,如:1828222534",
"example": "1828222534"
}
]
{"openapi":"3.1.1","info":{"title":"QQ等级查询","description":"获取 QQ 账号的全维度等级信息,包含 QQ 等级、总活跃天数、升级剩余天数、PC 端在线时长,以及 QQ 会员(等级、年标、成长值、到期时间、图标)、QQ 音乐绿钻(绿钻等级、年标状态、成长值)等核心权益信息。","version":"1.0.0"},"paths":{"/v1/qq_level.php":{"get":{"summary":"QQ等级查询","description":"获取 QQ 账号的全维度等级信息,包含 QQ 等级、总活跃天数、升级剩余天数、PC 端在线时长,以及 QQ 会员(等级、年标、成长值、到期时间、图标)、QQ 音乐绿钻(绿钻等级、年标状态、成长值)等核心权益信息。","parameters":[{"name":"qq","in":"query","required":true,"schema":{"type":"string","example":"1828222534"},"description":"需要查询的QQ号,如:1828222534"}],"responses":{"200":{"description":"成功","content":{"application/json":{"schema":{"type":"object"}}}}}},"post":{"summary":"QQ等级查询","description":"获取 QQ 账号的全维度等级信息,包含 QQ 等级、总活跃天数、升级剩余天数、PC 端在线时长,以及 QQ 会员(等级、年标、成长值、到期时间、图标)、QQ 音乐绿钻(绿钻等级、年标状态、成长值)等核心权益信息。","parameters":[{"name":"qq","in":"query","required":true,"schema":{"type":"string","example":"1828222534"},"description":"需要查询的QQ号,如:1828222534"}],"responses":{"200":{"description":"成功","content":{"application/json":{"schema":{"type":"object"}}}}}}}},"servers":[{"url":"http://xiaoapi.cn","description":"当前访问入口(http)"}]}
{
"code": 200,
"qq": "3414871787",
"qid": "subaiya",
"name": "rm -rf /苏白呀",
"avatar": "http://qh.qlogo.cn/g?b=sdk&ek=AQI6EwbD6rbLcAv1zY0yiakMrnW4QxGTWVuCEBeLED7HTGz7lZz0iaNKKRp3iczCVMX7WT92icn5M4lg5mJQGXiaNm8otTzcnQcp7nLlCvUicreVic3ib5JcQH0&s=100&t=1768406487",
"level": "128级",
"ico": "👑👑",
"iNextLevelDay": "4天",
"iTotalActiveDay": "17153天",
"pc_online": 0.8,
"vip": {
"year": "是",
"level": "10",
"value": 123537,
"ico": "https://imgcache.qq.com/vipstyle/component/img/nameplate/svip/lv/year-svip10-l1-on.png?max_age=2592000",
"expire": "2029-03-24 19:44:07"
},
"music_vip": {
"isyear": 0,
"level": 6,
"vip": 1,
"score": 31021
},
"tips": "慕名API:http://xiaoapi.cn"
}
提供 QQ 账号的全维度等级信息查询,包括 QQ 等级、总活跃天数、升级剩余天数、PC 端在线时长,以及 QQ 会员、QQ 音乐绿钻等核心权益状态。适用于需要查询好友或自身 QQ 账号等级与权益场景。
/v1/qq_level.php
GET、POST
无需密钥。
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| string | 是 | 需要查询的QQ号 |
参数取值说明
1828222534{
"code": 0,
"msg": "success",
"data": {
"qq": "1828222534",
"level": 48,
"total_active_days": 2190,
"remaining_days": 45,
"pc_online_hours": 156,
"vip": {
"is_vip": true,
"level": 6,
"annual": true,
"growth_value": 15800,
"expire_time": "2025-08-15"
},
"green_vip": {
"is_green_vip": true,
"level": 8,
"annual": false,
"growth_value": 8200
}
}
}
| 字段 | 类型 | 说明 |
|---|---|---|
| code | int | 状态码,0 表示成功 |
| msg | string | 状态描述信息 |
| data | object | 查询结果数据对象 |
| data.qq | string | 查询的 QQ 号 |
| data.level | int | QQ 等级 |
| data.total_active_days | int | 总活跃天数 |
| data.remaining_days | int | 距离下一等级剩余天数 |
| data.pc_online_hours | int | PC 端累计在线时长(小时) |
| data.vip | object | QQ 会员信息 |
| data.vip.is_vip | bool | 是否为 QQ 会员 |
| data.vip.level | int | QQ 会员等级 |
| data.vip.annual | bool | 是否为年费会员 |
| data.vip.growth_value | int | 会员成长值 |
| data.vip.expire_time | string | 会员到期时间(YYYY-MM-DD 格式) |
| data.green_vip | object | QQ 音乐绿钻信息 |
| data.green_vip.is_green_vip | bool | 是否为绿钻会员 |
| data.green_vip.level | int | 绿钻等级 |
| data.green_vip.annual | bool | 是否为年费绿钻 |
| data.green_vip.growth_value | int | 绿钻成长值 |
当请求处理失败时,接口返回统一格式的错误响应。以下为典型的错误响应示例:
{"code":0,"msg":"请求过于频繁,请稍后再试","errcode":11005}
本接口采用统一的错误码体系,所有错误响应均包含 code、msg 和 errcode 字段。errcode 为数值型错误代码,msg 为对应的中文描述。
| 错误码 | 说明 |
|---|---|
| 11001 | 未提供调用密钥 |
| 11002 | 密钥错误 |
| 11003 | 密钥已禁用 |
| 11004 | 积分余额不足 |
| 11005 | 请求过于频繁(QPM 限制) |
| 11006 | 接口维护中 |
| 11007 | 接口已禁用 |
| 11008 | 接口不可用 |
| 11009 | 密钥校验暂不可用 |
| 11010 | 积分系统暂不可用 |
| 11011 | 收费接口须提供有效密钥 |
| 11012 | 鉴权方式错误 |
| 11013 | 接口不存在 |
| 11014 | ***地址无效 |
| 11015 | ***地址不允许 |
| 11016 | ***请求失败 |
| 11017 | 服务暂不可用 |
| 11018 | 请求方式不允许 |
| 11019 | 当前IP不在白名单内 |
| 11020 | 启用出口代理须提供有效密钥 |
| 11021 | 未配置可用出口代理 |
| 11022 | 出口代理不可用 |
| 11023 | 密钥已过期 |
| 11024 | 令牌分配积分不足 |
curl -X POST "https://api.example.com/v1/qq_level.php" \
-d "qq=1828222534"
// 初始化请求
$ch = curl_init();
// 设置请求参数
$url = "https://api.example.com/v1/qq_level.php";
$params = ["qq" => "1828222534"];
// POST 请求
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query($params));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
// 发送请求并获取响应
$response = curl_exec($ch);
// 解析返回数据
$result = json_decode($response, true);
// 输出结果
print_r($result);
// 关闭连接
curl_close($ch);
qq 参数,值为待查询的 QQ 号,建议使用纯数字字符串格式,避免携带空格或特殊字符。curl "http://xiaoapi.cn/v1/qq_level.php?qq=1828222534"
// 结果将在此处显示