用户绑定QQ接口

用于实现用户账号绑定QQ的功能，支持通过GET方式传递参数。参数需根据后台是否启用“用户令牌校验”灵活选择：启用则仅需传token，无需传user和pass；未启用则需传user和pass，应用签名直接从后台获取。

请求地址 GET / POST

https://nobase.cn/api/user/qq

请求参数

参数名	类型	必选	说明
appid	string	✅ 是	应用ID，填写从开发者中心获取的应用唯一标识
qq	string	✅ 是	QQ账号，填写需要绑定的有效QQ号（需符合纯数字格式，避免包含特殊字符或空格）
signature	string	✅ 是	应用签名，直接从后台复制获取，无需手动生成
token	string	❌ 否	用户令牌，仅在后台应用配置启用“用户令牌校验”时需传递；启用后无需再传user和pass
user	string	条件必选	用户账号，仅在未启用“用户令牌校验”时需填写
pass	string	条件必选	用户密码，仅在未启用“用户令牌校验”时需填写

返回示例

成功响应（QQ绑定成功）

{
  "code": 200,
  "msg": "success",
  "data": "更新成功"
}

返回数据结构

参数名	类型	说明
code	number	状态码：200=绑定成功，400=参数错误/业务失败（如QQ已绑定、令牌无效），500=系统错误
msg	string	状态描述：success=成功，fail=失败
data	string	响应数据：code=200时为成功提示字符串，code≠200时为具体错误提示字符串

代码示例

JavaScript (启用令牌)

// 1. 配置参数（启用令牌校验：传token，无需传user和pass；signature从后台复制）
const appid = "your_app_id"; // 应用ID（必填）
const token = "user_token_from_login"; // 登录成功后获取的有效用户令牌（必填）
const qqNumber = "123456789"; // 需要绑定的QQ号（必填）
const signature = "signature_copied_from_backend"; // 从后台复制的应用签名（必填）

// 2. 拼接GET参数
const params = new URLSearchParams({
  appid,
  token,
  qq: qqNumber,
  signature
});

// 3. 发起GET请求
const requestUrl = `https://nobase.cn/api/user/qq?${params.toString()}`;
fetch(requestUrl)
  .then(response => {
    if (!response.ok) throw new Error(`HTTP错误：${response.status}`);
    return response.json();
  })
  .then(res => {
    if (res.code === 200) {
      console.log("QQ绑定成功：", res.data);
      alert("QQ账号绑定成功！");
    } else {
      console.error("QQ绑定失败：", res.data);
      alert(`绑定失败：${res.data}`);
    }
  })
  .catch(error => {
    console.error("请求异常：", error);
    alert("网络异常，请检查网络后重试");
  });

JavaScript (未启用令牌)

// 1. 配置参数（未启用令牌校验：传user和pass，无需传token；signature从后台复制）
const appid = "your_app_id"; // 应用ID（必填）
const user = "user123456"; // 用户账号（必填）
const pass = "user_password123"; // 用户密码（必填）
const qqNumber = "987654321"; // 需要绑定的QQ号（必填）
const signature = "signature_copied_from_backend"; // 从后台复制的应用签名（必填）

// 2. 拼接GET参数
const params = new URLSearchParams({
  appid,
  user,
  pass,
  qq: qqNumber,
  signature
});

// 3. 发起GET请求
const requestUrl = `https://nobase.cn/api/user/qq?${params.toString()}`;
fetch(requestUrl)
  .then(response => response.json())
  .then(res => {
    if (res.code === 200) {
      console.log("QQ绑定成功：", res.data);
    } else {
      console.error("QQ绑定失败：", res.data);
    }
  })
  .catch(error => console.error("请求异常：", error));

Python (启用令牌)

import requests

# 1. 配置参数（启用令牌校验：传token，无需传user和pass）
appid = "your_app_id"  # 应用ID（必填）
token = "user_token_from_login"  # 用户令牌（必填）
qq_number = "112233445"  # 绑定的QQ号（必填）
signature = "signature_copied_from_backend"  # 从后台复制的应用签名（必填）

# 2. 构造GET参数
params = {
    "appid": appid,
    "token": token,
    "qq": qq_number,
    "signature": signature
}

# 3. 发起GET请求
url = "https://nobase.cn/api/user/qq"
try:
    response = requests.get(url, params=params, timeout=5)
    response.raise_for_status()  # 抛出HTTP错误
    res_data = response.json()

    if res_data["code"] == 200:
        print(f"QQ绑定结果：{res_data['data']}")
        print(f"已绑定QQ号：{qq_number}")
    else:
        print(f"QQ绑定失败：{res_data['data']}")

except requests.exceptions.RequestException as e:
    print(f"请求异常：{str(e)}")

Python (未启用令牌)

import requests

# 1. 配置参数（未启用令牌校验：传user和pass，无需传token）
appid = "your_app_id"  # 应用ID（必填）
user = "user123456"  # 用户账号（必填）
passwd = "user_password123"  # 用户密码（必填）
qq_number = "556677889"  # 绑定的QQ号（必填）
signature = "signature_copied_from_backend"  # 从后台复制的应用签名（必填）

# 2. 构造GET参数
params = {
    "appid": appid,
    "user": user,
    "pass": passwd,
    "qq": qq_number,
    "signature": signature
}

# 3. 发起GET请求
url = "https://nobase.cn/api/user/qq"
try:
    response = requests.get(url, params=params, timeout=5)
    res_data = response.json()

    if res_data["code"] == 200:
        print(f"操作结果：{res_data['data']}")
    else:
        print(f"失败原因：{res_data['data']}")

except requests.exceptions.RequestException as e:
    print(f"请求异常：{str(e)}")

注意事项

1. 参数选择规则：后台启用“用户令牌校验”后，仅需传递 appid、token、qq、signature；未启用时，需传递 appid、user、pass、qq、signature，禁止同时传递 token 和 user/pass，避免参数冲突。
2. QQ号格式要求：qq 参数需为纯数字格式，长度通常为5-13位；若包含非数字字符（如空格、字母），会返回“QQ号格式错误”，需提前在前端做格式校验。
3. 签名与令牌有效性：signature 直接从后台复制，确保无字符缺失；启用令牌校验时，需使用未过期的有效Token，过期后需引导用户重新登录获取。
4. 业务失败场景：常见失败原因包括“QQ号已绑定其他账号”“令牌无效”“账号密码错误”，需根据 data 字段返回的提示，在前端展示友好文案（如“该QQ号已绑定其他账号，请更换QQ号或解绑后再试”）。
5. 安全提示：未启用令牌校验时，pass 参数以明文传递，建议生产环境使用HTTPS协议；优先推荐启用令牌校验，减少敏感信息暴露风险。