GET
免费
KEY必填
名言作图
/api/img/saying.php
QQ群抽字符
QQ群抽字符
接口信息
GET
shutiao.wsff.cn/api/qq/qun_getLuck.php
Method
GET
分类
QQ
Calls
30
KEY
KEY 必填
计费
免费
QPM
不限制
鉴权方式
Query 参数
作者
请求参数
| 参数名 | 类型 | 必填 | 说明 | 示例 |
|---|---|---|---|---|
| key | string | 是 | 接口调用密钥 | |
| skey | string | 是 | 机器人的skey | |
| p_skey | string | 是 | 机器人的qun.qq.com的pskey | |
| uin | integer | 是 | 机器人的QQ号 | |
| qun | string | 是 | 要抽字符的QQ群 |
[
{
"name": "key",
"type": "string",
"required": true,
"description": "接口调用密钥",
"example": ""
},
{
"name": "skey",
"type": "string",
"required": true,
"description": "机器人的skey",
"example": ""
},
{
"name": "p_skey",
"type": "string",
"required": true,
"description": "机器人的qun.qq.com的pskey",
"example": ""
},
{
"name": "uin",
"type": "integer",
"required": true,
"description": "机器人的QQ号",
"example": ""
},
{
"name": "qun",
"type": "string",
"required": true,
"description": "要抽字符的QQ群",
"example": ""
}
]
{"openapi":"3.1.1","info":{"title":"QQ群抽字符","description":"QQ群抽字符","version":"1.0.0"},"paths":{"/api/qq/qun_getLuck.php":{"get":{"summary":"QQ群抽字符","description":"QQ群抽字符","parameters":[{"name":"key","in":"query","required":true,"schema":{"type":"string"},"description":"接口调用密钥"},{"name":"skey","in":"query","required":true,"schema":{"type":"string"},"description":"机器人的skey"},{"name":"p_skey","in":"query","required":true,"schema":{"type":"string"},"description":"机器人的qun.qq.com的pskey"},{"name":"uin","in":"query","required":true,"schema":{"type":"integer"},"description":"机器人的QQ号"},{"name":"qun","in":"query","required":true,"schema":{"type":"string"},"description":"要抽字符的QQ群"}],"responses":{"200":{"description":"成功","content":{"application/json":{"schema":{"type":"object"}}}}}}}},"servers":[{"url":"http://shutiao.wsff.cn","description":"当前访问入口（http）"}]}
返回示例
看文档
详细文档
QQ群抽字符
接口说明
本接口用于在指定 QQ 群内执行抽字符活动，适用于机器人或群管理工具发起随机抽取任务。接口无需额外密钥鉴权，调用方需提供必要的机器人凭证及目标群号信息。
调用地址
本接口对外提供的调用地址为：
https://api.styyds.qzz.io/api/qq/qun_getLuck.php请求方式
本接口采用 GET 请求方式。调用方需向上述地址发送 HTTP GET 请求，并将所需参数以查询字符串的形式附加在 URL 之后。
鉴权说明
本接口无需密钥鉴权。调用时不需要在请求头或 URL 中携带任何认证凭证，直接发起请求即可。
请求参数
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| skey | string | 是 | 机器人的skey |
| p_skey | string | 是 | 机器人的qun.qq.com的pskey |
| uin | integer | 是 | 机器人的QQ号 |
| qun | string | 是 | 要抽字符的QQ群 |
成功响应示例
{
"code": 200,
"msg": "success",
"data": {
"luck": "L",
"name": "Lucky"
}
}响应字段说明
| 字段 | 类型 | 说明 |
|---|---|---|
| code | integer | 状态码，200 表示成功 |
| msg | string | 状态信息，success 表示成功 |
| data | object | 返回的数据内容 |
| data.luck | string | 抽取到的字符 |
| data.name | string | 对应字符的名称 |
错误响应示例
{"code":0,"msg":"未提供调用密钥","errcode":11001}
业务错误码说明
| errcode | 含义 |
|---|---|
| 11001 | 未提供调用密钥 |
| 11002 | 密钥错误 |
| 11003 | 密钥已禁用 |
| 11004 | 积分余额不足 |
| 11005 | 请求过于频繁（QPM 限制） |
| 11006 | 接口维护中 |
| 11007 | 接口已禁用 |
| 11008 | 接口不可用 |
| 11009 | 密钥校验暂不可用 |
| 11010 | 积分系统暂不可用 |
| 11011 | 收费接口须提供有效密钥 |
| 11012 | 鉴权方式错误 |
| 11013 | 接口不存在 |
| 11014 | ***地址无效 |
| 11015 | ***地址不允许 |
| 11016 | ***请求失败 |
| 11017 | 服务暂不可用 |
| 11018 | 请求方式不允许 |
| 11019 | 当前IP不在白名单内 |
| 11020 | 启用出口代理须提供有效密钥 |
| 11021 | 未配置可用出口代理 |
| 11022 | 出口代理不可用 |
| 11023 | 密钥已过期 |
| 11024 | 令牌分配积分不足 |
调用示例
终端 curl（bash）
curl -G "https://api.styyds.qzz.io/api/qq/qun_getLuck.php" \
--data-urlencode "skey=your_skey_here" \
--data-urlencode "p_skey=your_p_skey_here" \
--data-urlencode "uin=123456789" \
--data-urlencode "qun=123456789"
PHP
// PHP 示例
$params = [
'skey' => 'your_skey_here',
'p_skey' => 'your_p_skey_here',
'uin' => 123456789,
'qun' => '123456789'
];
$url = 'https://api.styyds.qzz.io/api/qq/qun_getLuck.php?' . http_build_query($params);
$response = file_get_contents($url);
echo $response;
注意事项
- 本接口无需密钥，请勿在前端页面或客户端代码中暴露
skey、p_skey、uin等敏感参数，以防账号被盗用。 - 所有请求参数均为必填项，缺少任意一项将导致请求失败，请确保参数完整且类型正确。
skey和p_skey为机器人登录凭证，具有高危险性，请妥善保管，定期更换，并避免通过日志、错误信息或 URL 查询字符串泄露。uin必须为机器人账号的实际 QQ 号码（整数），非昵称或群号，错误填写将导致鉴权失败。qun参数应为目标 QQ 群的完整群号（字符串形式），不支持群名称或群昵称，请确保群号准确无误。- 建议使用 HTTPS 请求，避免中间人攻击导致凭证被窃取。
- 接口调用频率建议控制在合理范围内，频繁请求可能触发 QQ 风控或服务限制，导致临时封禁。
- 返回结果为纯文本或 JSON（具体格式见实际响应），请根据实际返回内容进行解析，不要假设固定结构。
- 本服务为免费提供，但滥用行为（如批量刷取、脚本攻击）将导致 IP 或账号被永久拉黑。
- 若长时间不使用，建议及时失效或更新
skey和p_skey，以减少凭证泄露风险。
快速上手
curl -G "https://api.styyds.qzz.io/api/qq/qun_getLuck.php" \
--data-urlencode "skey=YOUR_SKEY" \
--data-urlencode "p_skey=YOUR_P_SKEY" \
--data-urlencode "uin=123456789" \
--data-urlencode "qun=987654321"在线测试
请求地址
shutiao.wsff.cn/api/qq/qun_getLuck.php
参数
Response
// 结果将在此处显示