Skip to content

ntlogin_query_security_verify_qr ​

NT 查询安全验证二维码。

适用协议

Android / Linux QQ;仅用于当前登录流程要求的设备安全验证。

调用方式 ​

json
{
  "type": "action",
  "id": "ntlogin_query_security_verify_qr-1",
  "action": "ntlogin_query_security_verify_qr",
  "params": {
    "self_id": 123456789,
    "protocol_id": 0,
    "guarantee_token": "当前验证令牌"
  }
}

参数 ​

参数类型必填说明
self_idnumber是当前框架内的 QQ 号,5–10 位整数。
protocol_idnumber是账号实例的协议 ID;必须显式提供,0 是有效 ID。用 get_protocol_list 查询,不使用 client_type 替代。
guarantee_tokenstring是get_security_verify_qr 返回的当前令牌。

返回值 ​

data 的基本字段为 code: number、message: string、next: string。

next后续步骤
done登录完成
slider用 slider_url 完成验证,再调用 submit_slider
security按 security_verify 或 get_security_verify_methods 的可用方式继续
identity使用 identity_url 开始身份验证
qrLinux 扫码登录,轮询 query_login_qr
failed本次登录失败,读取 code/message

验证分支按实际响应附加 slider_url、identity_url、security_url、security_verify 或 security_verify_error。外层 ok: true 只表示调用已返回结果,不能代替登录成功判断。

等待结果还包含 status/status_code。status 为 waiting、scanned、confirmed、expired 或 canceled;confirmed 后仍需检查 next 是否 done。

注意事项 ​

仅用于 nt=1 的账号;验证结果必须属于当前登录会话。

调用条件 ​

该接口用于当前账号自身登录。Free 不可调用;Plus / Pro 不设 QQ 等级前置条件,无需先登录账号再核验等级。仍须通过 VM 实时权益检查。账号归属、插件权限、平台授权与腾讯安全验证仍须满足,不能绕过安全确认。

以上限制针对插件 API,框架管理员账号页的正常扫码和免扫登录保持原有规则。

萌卡 · 自托管 QQ 机器人框架