get_account_delegation

使用本安装实例取得的凭据查询原始委托状态。

适用协议

Android / Linux QQ；仅限已授权的托管 IPC 插件，HTTP / WebSocket 不可调用。

插件清单及当前连接必须获准调用对应动作。安装实例和授权标识由框架注入，不能通过请求参数指定或伪造。接口只增加业务限制，不授予实例授权、权益或 QQ 等级豁免。

调用方式

{
  "type": "action",
  "id": "get_account_delegation-1",
  "action": "get_account_delegation",
  "params": {
    "receipt": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
  }
}

示例中的 QQ、指纹 ID、到期时间和凭据请替换为真实值。

参数

参数	类型	必填	说明
receipt	string	是	框架返回的原始委托凭据。

不接受 QQ 号选择器，也不能枚举其他账号是否存在。未知或其他安装实例的凭据统一拒绝。

present 表示原始绑定仍在，仍需检查允许项和到期时间；outside_scope、replaced、revoked 都不允许回收账号所有权。deleted 表示查询时原生命周期已删除且没有同 QQ、同协议的替代账号。清理插件本地归属前，还必须调用释放接口重新核验。

安装实例的授权撤销后，只能取得 revoked 状态，不返回新账号信息。

返回值

成功响应的 data 为委托快照：

字段	类型	说明
receipt	string	不透明委托凭据；只保存在插件服务端私有存储中
revision	integer	当前修订号，用于后续更新或释放的并发校验
status	string	present、deleted、outside_scope、replaced 或 revoked
allow_login	boolean	仅 present 时提供，是否允许登录
allow_tasks	boolean	仅 present 时提供，是否允许执行等级任务
expires_at	integer	仅 present 时提供，UTC Unix 秒；仍需检查是否已过期
released	boolean	释放成功时为 true，其余情况省略

响应不包含 QQ 号、设备指纹、其他所有者或迁移目标信息。网络、数据库和权限错误都返回失败，不能当作账号已删除。

状态语义和完整流程见托管 IPC 委托接口。