open_account_security_access
调用当前待验证登录的安全验证步骤。
适用协议
Android / Linux QQ(NTLogin);可用验证类型由当前账号返回的验证流程决定。
调用方式
json
{
"type": "action",
"id": "open_account_security_access-1",
"action": "open_account_security_access",
"params": {
"self_id": 123456789,
"protocol_id": 0,
"type": "QueryVerifyList",
"data": {}
}
}参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
self_id | number | 是 | 当前框架内的 QQ 号,5–10 位整数。 |
protocol_id | number | 是 | 账号实例的协议 ID;必须显式提供,0 是有效 ID。用 get_protocol_list 查询,不使用 client_type 替代。 |
type | string | 是 | QQ 安全验证方法,例如 QueryVerifyMethod、GetSMS、CheckSMS、CreateGuarantee、QueryGuaranteeStatus;支持方法随协议平台而异。 |
data | object | 否 | 该方法的参数;省略时为空对象。 |
返回值
data 为该安全验证方法的原生返回;调用失败可能返回 code/message/next=failed。
当 type 为 getToken 且成功时,data 包含:
| 字段 | 类型 | 说明 |
|---|---|---|
token | string | 当前账号和设备的 QQ 安全访问票据;按敏感凭据处理,不写入公开日志。 |
expiresAt | number | string | 服务返回的到期时间。Linux 3.2.34 使用无符号整数的十进制字符串;Android 和 Linux 3.2.32 保持 number。 |
字符串形式的 expiresAt 应原样保留,不要转成 JavaScript Number;需要整数运算时使用 BigInt。失败结果仍读取 code、message、next,不能将缺少 token 的响应当作成功。
注意事项
只能用于当前待验证账号会话,不是任意 SSO 透传。常规登录应优先使用 get_security_verify_methods / get_sms / check_sms 等专用接口。
