Appearance
用户解绑QQ POST
用户名密码验证后清空账号的 QQ 绑定(openid + access_token),之后可重新绑定另一个 QQ。
请求方法:
POSTContent-Type:application/x-www-form-urlencoded
💡 SDK 快速接入
官方 SDK 已支持此接口,您可以直接使用 SDK 一键调用,无需手动处理加密和签名。
SDK 调用示例
python
result = verify.unbind_qq('username', 'password')
if result['success']:
print("解绑成功")javascript
const result = await verify.unbindQq('username', 'password');
if (result.success) console.log('解绑成功');java
T3Verify.T3Result result = verify.unbindQq("username", "password");
if (result.success) System.out.println("解绑成功");csharp
var result = verify.UnbindQq("username", "password");
if (result.Success) Console.WriteLine("解绑成功");php
$result = $verify->unbindQq('username', 'password');
if ($result['success']) echo "解绑成功\n";为什么用户名密码而不是 QQ 凭证解绑
QQ 授权可能被盗(QQ 号被盗、access_token 泄漏),如果允许 QQ 凭证解绑,攻击者拿到凭证后能反复解绑再绑到自己的 QQ。用密码解绑更安全,也符合"忘记 QQ 密码 → 用账号密码解绑重绑"的实际场景。
请求参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
user | string | 必填 | 用户名 |
pass | string | 必填 | 密码 |
t | number | 条件必填 | 秒级 Unix 时间戳 |
s | string | 条件必填 | 请求签名 |
safe_code | string | 可选 | 数据验证码 |
成功响应
jsonc
{
"code": "200",
"msg": "解绑成功"
}txt
解绑成功错误列表
业务错误
| 错误消息 | 原因 |
|---|---|
用户名不可为空 | 未传 user |
密码不可为空 | 未传 pass |
用户名或密码错误 | 用户不存在或密码错 |
用户被禁用 | 用户 active=0 |
用户未激活 | 账号 use_time=0 且 mode!=2 |
用户使用时间已到期 | 账号已过期且 mode!=2 |
该用户未绑定QQ | 账号 openid 为空(本来就没绑过 QQ) |
解绑失败 | 数据库写入失败 |
通用错误
| 错误消息 | 原因 |
|---|---|
程序未开启 / 接口未开启 | 程序或接口未启用 |
时间戳参数不可为空 | 开启时间戳验证但未传 t |
验证数据已失效,请重试 | 时间戳校验失败 |
签名参数不可为空 | 开启签名验证但未传 s |
签名有误 | 签名校验失败 |