release_account_delegation
在账号确已删除时,原子核验并释放原始委托。
适用协议
Android / Linux QQ;仅限已授权的托管 IPC 插件,HTTP / WebSocket 不可调用。
插件清单及当前连接必须获准调用对应动作。安装实例和授权标识由框架注入,不能通过请求参数指定或伪造。接口只增加业务限制,不授予实例授权、权益或 QQ 等级豁免。
调用方式
json
{
"type": "action",
"id": "release_account_delegation-1",
"action": "release_account_delegation",
"params": {
"receipt": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"revision": 1
}
}示例中的 QQ、指纹 ID、到期时间和凭据请替换为真实值。
参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
receipt | string | 是 | 本安装实例持有的原始委托凭据。 |
revision | integer | 是 | 最近读取的修订号,至少为 1。 |
仅 deleted 状态允许释放。框架在同一事务内复查授权、凭据归属、修订号和替代账号,不会把先前的删除查询作为永久凭证。
成功返回 status: "deleted" 及 released: true。账号仍未重建时,同修订号重试具有幂等性;账号重建后会冲突。插件只在明确收到 released: true 后清理本地归属。
此接口不删除框架账号、插件业务数据或资金;present、移动、替代或撤销状态均拒绝释放。
返回值
成功响应的 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 委托接口。
