Skip to content

auth_qr

使用在线 Android Bot 确认一个已经扫描的 QQ 登录二维码。通常在 scan_qr 返回可确认状态后调用;本接口不属于 Linux 原生账号管理链路。

调用

js
const androidApi = api.forProtocol('android')
const result = await androidApi.auth_qr(123456789, qrK)

参数

参数类型必填说明
self_idnumber执行授权动作的在线 Android Bot QQ 号
kstring已扫描二维码中的 k 参数或完整 URL
skip_phone_confirmboolean是否请求跳过手机端二次确认,默认 false;QQ 服务端可能忽略

返回值

返回 successcodemessage、目标账号和设备信息。success: true 表示 Android 授权请求已受理,最终登录结果由二维码所属的原流程负责确认。

授权接口具有登录影响,不要自动无限重试。账号不一致、二维码过期或 Android Bot 离线时应重新开始完整流程。

v2.0.6同步修复平板协议扫码授权的 AppID 字段选择,使用同版本 Phone 项的 appid。两名测试账号均已完成扫码、授权、Linux 确认上线及双 WS 上线事件验证;最终账号状态仍应由 query_login_qr_status 或原登录流程确认。

调用前必读

协议与使用指南

仅 Android
适用协议
仅 Android
使用前准备
执行扫码或授权的 Android 账号必须在线。先 scan_qr,再 auth_qr,使用同一二维码的 k。Linux 免扫登录由同 QQ 在线安卓账号执行这两步,再由 Linux 原生登录链路查询结果。
选择协议
const androidApi = api.forProtocol('android') // 省略时也默认 Android

原始 action 请求只使用附件约定的 client_type: 'android' | 'linuxqq';省略时选择 Android。

建议搭配

常见失败原因

  • bot 不属于本节点
  • bot 未在线或账号状态不符合要求
  • client_type 无效或目标协议不支持该 action

注意事项

  • 省略协议选择器时默认 Android;若指定 Linux,框架会明确拒绝,不会转交同 QQ 的 Android 实例。
  • 调用方协议必须为 android,不能把动作发送给 Linux 会话。授权成功后仍需查询目标二维码流程确认登录;授权失败不自动重放。

萌卡NT 开发文档