接口文档

1快速开始

2对接凭据

3签名机制

签名步骤

1. 收集所有业务参数（app_id、timestamp、nonce 以及接口自身的其他参数，不含 sign），过滤掉空值。
2. 按参数名字典序排序。
3. 拼成 key1=urlencode(value1)&key2=urlencode(value2) 格式（rawurlencode）。
4. 使用 App Secret 作为 key，对拼接串做 HMAC-SHA256，输出小写 hex。

签名示例（PHP）

// 1. 准备参数
$params = [
    'app_id'    => 'a1b2c3d4e5f60789',
    'cross_site' => 'https://your-site.com/callback',
    'timestamp'  => time(),
    'nonce'      => bin2hex(random_bytes(16)),
];

// 2. 过滤空值 + 字典序排序
$params = array_filter($params, fn($v) => $v !== '' && $v !== null);
ksort($params);

// 3. 拼接（rawurlencode）
$parts = [];
foreach ($params as $k => $v) {
    $parts[] = $k . '=' . rawurlencode((string)$v);
}
$signStr = implode('&', $parts);

// 4. HMAC-SHA256
$appSecret = '你的AppSecret';
$sign = hash_hmac('sha256', $signStr, $appSecret);

// 5. 最终请求携带 sign
$params['sign'] = $sign;

5接口一：发起登录跳转

请求参数

回调返回（重定向到您的 cross_site）

https://your-site.com/callback?token=2f8e3b...&from=qq_login_api

6接口二：Token 交换用户信息

请求参数

响应示例

{
  "code": 200,
  "message": "Token验证成功",
  "data": {
    "is_login": true,
    "user": {
      "id": 128,
      "nickname": "小明",
      "avatar": "https://thirdqq.qlogo.cn/.../100",
      "gender": 1,
      "qq_openid": "A1B2C3D4E5F6..."
    }
  },
  "timestamp": 1722585600
}

错误码

7接口三：查询用户信息

请求参数

响应示例

{
  "code": 200,
  "message": "查询成功",
  "data": {
    "user": {
      "id": 128,
      "nickname": "小明",
      "avatar": "https://thirdqq.qlogo.cn/.../100",
      "gender": 1,
      "qq_openid": "A1B2C3D4E5F6...",
      "last_login_time": "2026-08-02 10:23:45"
    }
  },
  "timestamp": 1722585600
}

错误码

8通用响应结构

{
  "code": 200,
  "message": "说明文本",
  "data": { /* 业务数据 */ },
  "timestamp": 1722585600
}

9辅助接口