QQ全部群抽字符

接口说明

一次性为指定 QQ 账号完成其全部可参与的群「抽字符」操作，适合希望省去逐群手动点击的用户。调用时需提供该账号的 QQ 号及其登录态凭证，接口会自动遍历其有权限的群并执行抽字符。全程免费、无需密钥。

调用地址

https://api.styyds.qzz.io/api/qq/qun_getLuck_all.php

该地址为本接口唯一对外提供的完整调用地址（含站点域名与接口路径），直接拼接在调用方请求中即可，无需替换为其它域名。

请求方式

本接口采用 GET 请求方式。调用方只需向调用地址发起一次 GET 请求，即可触发对全部群聊的抽字符操作。

由于为 GET 请求，请求体不承载业务数据，参与逻辑处理的相关内容均以查询参数形式附加在调用地址之后（具体参数说明参见接口文档的参数部分）。

鉴权说明

本接口无需密钥，属于免鉴权接口类型。

具体而言：

• 调用时无需在请求中携带任何密钥标识、签名串或令牌；
• 无需设置任何用于存放密钥的请求头；
• 无需在调用地址后附加密钥类的查询参数。

因此，在具备网络访问能力的前提下，直接向调用地址发起 GET 请求并附带必要的业务参数即可完成调用，不会因为缺少鉴权凭证而被拒绝。本接口不计费，调用不消耗任何额度。

请求参数

本接口采用 GET 请求方式，所有参数通过 URL Query传递，参数名区分大小写。

参数取值说明

• uin：填写纯数字的 QQ 号，例如 10001。若号码不存在或已注销，则无法匹配到可抽字符的群。
• skey / pskey：均为登录态凭证，需属于同一 QQ 账号，且保持有效。由于两者仅在 URL 中传递，建议在本地及时更新，避免使用过期凭证导致抽字符失败。
• 三个参数必须同时提供，缺一不可；参数顺序不限，多余的无关参数会被忽略。

安全提示：skey 与 pskey 属于账号敏感凭证，请勿写入前端页面、公开仓库或分享给他人，也不要在日志、截图、群聊中泄露。若怀疑凭证已外泄，请立即在 QQ 端重新登录以刷新登录态。

成功响应示例

请求成功时，返回 HTTP 状态码 200，响应体为 JSON，格式如下：

{
  "code": 0,
  "msg": "ok",
  "data": {
    "groups_found": 109,
    "success_count": 109,
    "elapsed_sec": 22.56
  }
}

成功抽取到的成员信息以数组形式逐群返回，每个群一条记录。

响应字段说明

顶层字段

data 字段

错误响应示例

所有接口在业务处理失败时，均返回统一结构的 JSON，code 固定为 0，msg 为人类可读的中文提示，errcode 为具体的业务错误码；HTTP 状态码通常仍为 200，请以 errcode 判定结果。

鉴权类错误（适用于本站需要密钥的接口）：

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

密钥无效：

{"code":0,"msg":"密钥错误","errcode":11002}

密钥余额不足：

{"code":0,"msg":"积分余额不足","errcode":11004}

请求过于频繁（QPM 限制）：

{"code":0,"msg":"请求过于频繁","errcode":11005}

参数或业务错误示例：

{"code":0,"msg":"接口不存在","errcode":11013}

{"code":0,"msg":"请求方式不允许","errcode":11018}

{"code":0,"msg":"服务暂不可用","errcode":11017}

本接口（QQ全部群抽字符）说明：本接口无需密钥、免费调用，正常情况下不会返回 11001～11012、11019～11024 等鉴权与计费类错误。若响应中出现 errcode: 11017，表示服务端处理异常，请稍后重试；若出现 errcode: 11013、errcode: 11018，说明访问的地址或请求方式有误。本接口的 uin、skey、pskey 属于登录态参数，若参数缺失或已失效，一般直接返回业务失败结果而非上述错误码，此时应检查参数是否完整、是否已过期。

业务错误码说明

错误码归类说明：

• 鉴权类（11001～11003、11011、11012、11019～11024）：与调用密钥、鉴权方式、白名单及令牌额度相关。本接口无需密钥，正常调用不会触发此类错误码。
• 限流与状态类（11004～11010、11017）：包含余额不足、QPS/QPM 限制、维护、禁用、依赖服务不可用等运行状态提示。
• 请求与路由类（11013、11018）：地址拼写错误、接口已下线，或使用了不被允许的请求方式。
• ***与链路类（11014～11016、11020～11022）：面向需要访问外部数据源或经由链路转发的接口，出现时表示目标地址配置异常、访问不被允许或请求未能成功送达。

处理建议：收到非 0 结束语义之外的错误时，先按 errcode 对照上表定位；11017 类可重试，11013、11018 需修正地址或请求方式，11004、11005 需调整调用频率或额度。

调用示例

终端 curl（bash）

# 抽取全部群里的全抽字符
curl -s -G "https://api.styyds.qzz.io/api/qq/qun_getLuck_all.php" \
  --data-urlencode "uin=10001" \
  --data-urlencode "skey=你的skey" \
  --data-urlencode "pskey=你的pskey"

配合 jq 格式化输出：

curl -s -G "https://api.styyds.qzz.io/api/qq/qun_getLuck_all.php" \
  --data-urlencode "uin=10001" \
  --data-urlencode "skey=你的skey" \
  --data-urlencode "pskey=你的pskey" | jq

PHP

// PHP 8.x，无需密钥，直接发起 GET 请求
$url = 'https://api.styyds.qzz.io/api/qq/qun_getLuck_all.php';

$params = [
    'uin'   => '10001',
    'skey'  => '你的skey',
    'pskey' => '你的pskey',
];

$full = $url . '?' . http_build_query($params);

$ch = curl_init();
curl_setopt_array($ch, [
    CURLOPT_URL            => $full,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT        => 30,
    CURLOPT_SSL_VERIFYPEER => true,
]);
$response = curl_exec($ch);
if ($response === false) {
    $error = curl_error($ch);
    curl_close($ch);
    exit('请求失败：' . $error);
}
curl_close($ch);

$data = json_decode($response, true);
if (json_last_error() !== JSON_ERROR_NONE) {
    exit('返回内容不是合法 JSON：' . $response);
}

print_r($data);

注意事项

• 本接口无需密钥：调用时不带任何平台鉴权参数，地址可直接请求。但请注意「无需密钥」不等于「无鉴权」，账号身份完全依赖下方三个参数，参数缺失或错误会直接导致鉴权失败。
• skey 与 pskey 属于高敏感凭证：二者等同于 QQ 账号的登录态凭据，泄露后可能导致该 QQ 号被他人使用。务必保存在服务端环境变量或密钥管理服务中，严禁硬编码在源码里，也严禁写入日志、前端页面、URL 参数、截图或工单。
• 务必在后端调用：只能在你的服务端发起请求再把结果转发给前端；不要让浏览器直接请求本接口，否则 pskey 会暴露在用户可见的网络请求中。
• HTTPS 强制：pskey 只能通过 HTTPS 传输，请勿在非加密环境或明文日志中打印完整请求链接。
• pskey 区分站点：必须使用 qun.qq.com 域下的 pskey，与其他业务（如音乐、空间等）的 pskey 不通用，混用会提示登录态失效。
• 凭证有有效期：skey / pskey 会随账号重新登录、修改密码或退出设备而失效，接口将返回鉴权失败类结果。遇到此类提示应提示用户重新登录取回凭证后再试，不要无间隔重试。
• 调用频率：接口对当前账号的群列表执行实际拉取操作，短时间高频请求容易触发风控或被限流。建议做请求节流与结果缓存（群抽字符结果短时间内不会频繁变化），并对同一 uin 串行化调用。
• uin 与账号绑定：接口会作用于该 uin 名下的全部群，包含本人未设置为管理员但已加入的群，处理范围较大。若账号内群数量较多，返回耗时相应变长，请在前端设置合理的加载超时（建议不低于 30 秒）。
• 群成员数据范围：返回内容包含群成员昵称、QQ 号等个人信息，请仅用于业务自身展示与导出，不要二次分发或用于非授权用途。
• 失败重试策略：网络超时、5xx 等临时性错误可做有限次数退避重试；参数错误、凭证失效等确定性失败不要重试，直接提示用户。