get_rkey

读取当前账号用于私聊、群聊和媒体资源访问的 RKey。接口只返回框架登录后由后台刷新任务维护的缓存，不会因为插件调用而额外发送 RKey 请求。

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

返回当前有效的图片 RKey 集合及 expires_at（Unix 秒）。缓存未就绪或过期时失败。

适用协议

Android / Linux QQ；读取当前账号已获得的有效凭据，凭据未就绪时不可用。

调用方式

向已认证的 WebSocket 连接发送：

json

{
  "type": "action",
  "id": "example-1",
  "action": "get_rkey",
  "params": {
    "self_id": 123456789,
    "protocol_id": 0
  }
}

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

参数	类型	必填	说明
`self_id`	`integer`	是	当前框架内的账号 QQ 号
`protocol_id`	`integer`	是	账号协议配置 ID；从 get_protocol_list 获取，必须显式传入，0 也是有效 ID

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

字段	类型	说明
`items`	`object[]`	结果项列表
`expires_at`	`integer`	expires at