login_account
使用账号已保存的密码登录;Linux 未设置密码时获取登录二维码。
适用协议
Android / Linux QQ;Linux 未设置密码时可使用扫码登录。
调用方式
Linux 账号未保存密码时,本接口会转为获取自身登录二维码:Free 不可调用此扫码分支;Plus / Pro 不设 QQ 等级前置条件。仍须通过 VM 实时权益检查。使用已保存密码的常规登录及框架管理员账号页正常登录保持原有规则。账号归属、插件权限、平台授权与腾讯安全验证仍须满足。
json
{
"type": "action",
"id": "login_account-1",
"action": "login_account",
"params": {
"self_id": 123456789,
"protocol_id": 0
}
}参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
self_id | number | 是 | 当前框架内的 QQ 号,5–10 位整数。 |
protocol_id | number | 是 | 账号实例的协议 ID;必须显式提供,0 是有效 ID。用 get_protocol_list 查询,不使用 client_type 替代。 |
返回值
data 的基本字段为 code: number、message: string、next: string。
| next | 后续步骤 |
|---|---|
done | 登录完成 |
slider | 用 slider_url 完成验证,再调用当前登录方式对应的 ntlogin_submit_slider 或 wtlogin_submit_slider |
security | 按 security_verify 或 get_security_verify_methods 的可用方式继续 |
identity | 使用 identity_url 开始身份验证 |
qr | Linux 扫码登录,轮询 query_login_qr |
failed | 本次登录失败,读取 code/message |
验证分支按实际响应附加 slider_url、identity_url、security_url、security_verify 或 security_verify_error。外层 ok: true 只表示调用已返回结果,不能代替登录成功判断。
Linux 二维码结果还包含 command、ret_code、url、十六进制 qr_sig、self_id。将 url 绘制成二维码。
注意事项
密码登录要求账号离线。Linux 扫码等待期间再次调用可刷新过期二维码。此接口不接收 password;请先创建或编辑账号。
接口按账号保存的 nt 登录方式执行;密码请通过 add_account / update_account 保存。
