auth_qr

使用在线 Android Bot 确认一个已经扫描的 QQ 登录二维码。通常在 scan_qr 返回可确认状态后调用。

此接口在已认证的服务连接中调用，账号须属于当前框架且处于在线状态。self_id 与 protocol_id 共同选择账号。

适用协议

Android（手机 / 平板）；不支持 Linux QQ。

调用方式

Free 不可调用。Plus 每次调用核对当前 QQ 最新等级，至少需要 32 级；Pro 不设这项 QQ 等级门槛。QQ 返回的安全确认仍须由用户完成，不能通过此接口绕过。

向已认证的 WebSocket 连接发送：

{
  "type": "action",
  "id": "example-1",
  "action": "auth_qr",
  "params": {
    "self_id": 123456789,
    "protocol_id": 0,
    "k": "与scan_qr相同的实际k值",
    "need_a1": false
  }
}

响应通过相同 id 对应请求。连接、HTTP 调用与错误处理见通信协议。

参数

参数	类型	必填	说明
self_id	integer	是	当前框架内的账号 QQ 号
protocol_id	integer	是	账号协议配置 ID；从 get_protocol_list 获取，必须显式传入，0 也是有效 ID
k	string	是	与 scan_qr 相同的实际 k 值，不能为空
need_a1	boolean	是	原样传入 scan_qr 返回的 need_a1，包括 false；示例仅展示格式
skip_phone_confirm	boolean	否	是否跳过手机确认请求，默认值见扫码响应

返回值

以下为成功响应的 data，错误通过 ok: false 与 error 返回。

返回 QQ 扫码授权服务的 JSON 对象；字段随二维码业务而变化。调用成功只代表本次服务响应，是否需要手机确认或进一步授权以该响应为准。