用户QQ登录 POST

通过已绑定的 QQ 号快捷登录用户账号。请求方法： POST　　Content-Type： application/x-www-form-urlencoded

SDK 调用示例

PythonNode.jsJavaC#PHPpython

result = verify.qq_login('openid', 'access_token')
if result['success']:
    print(f"用户名: {result['username']}, 到期时间: {result['end_time']}")

javascript

const result = await verify.qqLogin('openid', 'access_token');
if (result.success) console.log(`用户名: ${result.username}, 到期时间: ${result.end_time}`);

java

T3Verify.T3LoginResult result = verify.qqLogin("openid", "access_token");
if (result.success) System.out.println("用户名: " + result.username + ", 到期时间: " + result.endTime);

csharp

var result = verify.QqLogin("openid", "access_token");
if (result.Success) Console.WriteLine($"用户名: {result.Username}, 到期时间: {result.EndTime}");

php

$result = $verify->qqLogin('openid', 'access_token');
if ($result['success']) echo "用户名: {$result['username']}, 到期时间: {$result['end_time']}\n";

前提条件用户需先通过绑定QQ 接口完成绑定。

请求参数

参数

类型

必填

说明

openid string 必填 QQ openid（32 位字母数字）

access_token string 必填 QQ access_token（32 位字母数字）

t number 条件必填秒级 Unix 时间戳

s string 条件必填请求签名

safe_code string 可选数据验证码

成功响应

JSON 格式文本格式jsonc

{
  "code": "200",                        // 状态码
  "id": 1,                              // 用户 ID
  "username": "alice",                  // 用户名 (账号)
  "recharge": 3,                        // 充值次数
  "use_time": "2026-03-01 10:00:00",    // 激活时间
  "end_time": "2026-04-10 10:00:00",    // 到期时间
  "available": 2592000,                  // 剩余秒数
  "token": "a1b2c3d4e5f6...",            // 校验密钥
  "statecode": "f1e2d3c4b5a6...",        // 登录状态码
  "time": 1741700000,                    // 服务器时间戳
  "date": "202603111200",               // 服务器日期分钟
  "change": 0,                           // 已解绑次数
  "core": "48656c6c6f"                   // 核心数据（Hex 编码）
}

txt

登录成功
用户ID:1
用户名:alice
充值次数:3
激活时间:2026-03-01 10:00:00
到期时间:2026-04-10 10:00:00
剩余时间:2592000
校验密钥:a1b2c3d4e5f6
登录状态码:f1e2d3c4b5a6
当前时间:202603111200
当前时间戳:1741700000
解绑次数:0
核心数据:48656c6c6f

错误列表

错误消息

原因

openid不可为空 未传 openid

access_token不可为空 未传 access_token

openid只能为英文或数字 openid 含非法字符

access_token只能为英文或数字 access_token 含非法字符

openid格式错误 openid 不是 32 位

access_token格式错误 access_token 不是 32 位

该QQ未绑定用户 未找到匹配的绑定记录

用户被禁用 用户被后台禁用

请先充值后使用 用户未充值激活

用户使用时间已到期 用户已过期

请在原IP登录 / 请在原省内登录 / 请在市内登录 IP 验证失败

程序未开启 / 接口未开启 程序或接口未启用

时间戳参数不可为空 开启时间戳验证但未传 t

验证数据已失效，请重试 时间戳校验失败（排障指南）

签名参数不可为空 开启签名验证但未传 s

签名有误 签名校验失败