参数名	类型	必填	说明	示例
key	string	是	接口调用密钥
qq	string	是	查询的QQ号	3121871622
uin	string	是	你的QQ号	3121871622
skey	string	是	skey值（从QQ会员网站获取）	@9XQK
pskey	string	是	CK中的p_skey值（从QQ会员网站获取）	N1mme
type	string	否	返回格式，默认json可选text	json

查询QQ详细信息

接口说明

通过QQ号查询对应的详细信息，获取QQ相关资料信息。
适用于需要查询QQ账号状态与基础信息的应用场景。

调用地址

https://api-v2.317ak.com/api/QQ/qq_ti_vip_info/api.php

请求方式

GET、POST

鉴权说明

本接口调用需要密钥鉴权，请通过 Query 参数方式传递接口调用密钥：

key=…

请求参数

参数名	类型	必填	说明
key	string	是	接口调用密钥
qq	string	是	查询的QQ号
uin	string	是	你的QQ号
skey	string	是	skey值（从QQ会员网站获取）
pskey	string	是	CK中的p_skey值（从QQ会员网站获取）
type	string	否	返回格式，默认json，可选text

成功响应示例

{
"code": 200,
"msg": "获取成功",
"qq": "3121871622",
"nickname": "残缺的爱",
"level": "84",
"level_icon": "",
"avatar_url": "http://qh.qlogo.cn/g?b=sdk&ek=example&s=100&t=1726195357",
"basic_info": {
"total_active_days": "7544",
"days_to_next_level": "21"
},
"vip_status": {
"is_vip": false,
"is_svip": false,
"vip_level": "7",
"is_year_vip": false
},
"online_status": {
"mobile_online": true,
"pc_online": true,
"invisible_online": false,
"mobile_online_time": "16小时11分31秒",
"pc_online_time": "3小时5分10秒",
"total_online_time": "19小时16分41秒",
"game_online": false
},
"acceleration_info": {
"daily_sign": true,
"real_days": "6.0",
"max_level_real_days": "6.1",
"continue_login": true
},
"other_info": {
"SVIPStar": "0",
"iBigClubLevel": "0",
"iSmallWorld": "0",
"iVipSpeedRate": "10",
"iYearBigClubFlag": "0",
"QzoneVisitor": "0",
"iCostMs": "40",
"iQzoneState": "0",
"iMedal": "0",
"iMqing": "0",
"iBaseDays": "1.5",
"iNoHideOnlineTime": "0",
"iSpeedType": "0",
"iSqqSpeedRate": "0",
"iTotalDays": "8.9",
"Lxby": "0",
"iBigClubGrowth": "0",
"iBigClubSpeed": "0",
"iBigClubVipFlag": "0",
"iPCSafeOnline": "0",
"WeishiVideoview": "1",
"iCmshowActive": "0",
"iQQSportStep": "0",
"iSvrDays": "4.5",
"speedStarv2": "0",
"iMaxLvlTotalDays": "11.3",
"iSqq": "0",
"iSqqLevel": "0",
"speedStarv3": "0",
"speedStar": "0",
"iAddFriend": "1"
}
}

响应字段说明

字段	类型	说明
code	number	响应状态标识
msg	string	响应提示信息
qq	string	查询的QQ号
nickname	string	QQ昵称
level	string	QQ等级
level_icon	string	等级图标信息
avatar_url	string	QQ头像地址
basic_info	object	基础信息
basic_info.total_active_days	string	累计活跃天数
basic_info.days_to_next_level	string	距离下一等级所需天数
vip_status	object	会员状态信息
vip_status.is_vip	boolean	是否为会员
vip_status.is_svip	boolean	是否为超级会员
vip_status.vip_level	string	会员等级
vip_status.is_year_vip	boolean	是否为年费会员
online_status	object	在线状态信息
online_status.mobile_online	boolean	移动端在线状态
online_status.pc_online	boolean	PC端在线状态
online_status.invisible_online	boolean	隐身在线状态
online_status.mobile_online_time	string	移动端在线时长
online_status.pc_online_time	string	PC端在线时长
online_status.total_online_time	string	总在线时长
online_status.game_online	boolean	游戏在线状态
acceleration_info	object	加速相关信息
acceleration_info.daily_sign	boolean	每日签到状态
acceleration_info.real_days	string	当前累计天数信息
acceleration_info.max_level_real_days	string	等级相关累计天数信息
acceleration_info.continue_login	boolean	连续登录状态
other_info	object	其他扩展信息
other_info.SVIPStar	string	超级会员星级信息
other_info.iBigClubLevel	string	大会员等级信息
other_info.iSmallWorld	string	小世界相关信息
other_info.iVipSpeedRate	string	速度相关信息
other_info.iYearBigClubFlag	string	年费会员标识信息
other_info.QzoneVisitor	string	空间访客相关信息
other_info.iCostMs	string	消耗相关信息
other_info.iQzoneState	string	空间状态信息
other_info.iMedal	string	勋章相关信息
other_info.iMqing	string	相关状态信息
other_info.iBaseDays	string	基础天数信息
other_info.iNoHideOnlineTime	string	在线时间显示状态
other_info.iSpeedType	string	加速类型信息
other_info.iSqqSpeedRate	string	相关加速信息
other_info.iTotalDays	string	总天数信息
other_info.Lxby	string	扩展信息
other_info.iBigClubGrowth	string	成长信息
other_info.iBigClubSpeed	string	加速信息
other_info.iBigClubVipFlag	string	会员标识信息
other_info.iPCSafeOnline	string	安全在线状态
other_info.WeishiVideoview	string	视频相关信息
other_info.iCmshowActive	string	活动状态信息
other_info.iQQSportStep	string	运动相关信息
other_info.iSvrDays	string	服务天数信息
other_info.speedStarv2	string	加速星级信息
other_info.iMaxLvlTotalDays	string	等级累计天数信息
other_info.iSqq	string	相关状态信息
other_info.iSqqLevel	string	相关等级信息
other_info.speedStarv3	string	加速星级扩展信息
other_info.speedStar	string	加速星级信息
other_info.iAddFriend	string	好友相关信息

错误响应示例

{
  "code":0,
  "msg":"未提供调用密钥",
  "errcode":11001
}

业务错误码说明

errcode	含义
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（bash）

curl -G "https://api-v2.317ak.com/api/QQ/qq_ti_vip_info/api.php" \
  --data-urlencode "key=你的接口密钥" \
  --data-urlencode "qq=3121871622" \
  --data-urlencode "uin=3121871622" \
  --data-urlencode "skey=@9XQK" \
  --data-urlencode "pskey=N1mme" \
  --data-urlencode "type=json"

PHP



## 注意事项

- 调用接口前请确保已配置有效调用密钥，密钥请妥善保存，避免公开发布或提交到前端代码、客户端包等容易泄露的位置。
- 本接口通过 Query 方式传递鉴权参数，请使用 `key` 参数进行调用。
- 请求地址必须使用 HTTPS 访问，确保传输过程中的数据安全。
- `qq` 参数用于指定需要查询的 QQ 号，请确认填写格式正确，避免因参数错误导致查询失败。
- `uin`、`skey`、`pskey` 参数为查询所需信息，请确保参数有效且对应正确账号环境，否则可能影响返回结果。
- `type` 参数可选，未填写时默认返回 JSON 格式；如需其他返回格式，请按照接口支持的取值填写。
- 请合理控制接口调用频率，避免短时间内大量重复请求影响正常使用。
- 接口返回内容可能因 QQ 账号状态、权限或相关信息变化而有所不同，请以实际返回结果为准。

查询QQ详细信息

接口信息

请求参数

返回示例

详细文档

查询QQ详细信息

接口说明

调用地址

请求方式

鉴权说明

请求参数

成功响应示例

响应字段说明

错误响应示例

业务错误码说明

调用示例

终端 curl（bash）

PHP

快速上手

在线测试

接口反馈

推荐接口

今日黄历