Skip to content

数据缓存 ​

缓存接口用于下载账号数据快照和恢复 JSON 快照。

下载普通缓存 ​

http
POST /cache/backup
json
{
  "token": "<TOKEN>"
}

响应中的 data 为服务返回的备份对象:

json
{
  "success": true,
  "msg": "success",
  "data": { "...": "..." }
}

客户端应把完整响应中的 data 保存为 JSON,并记录账号名称、导出时间和版本。

恢复缓存 ​

http
POST /cache/restore
json
{
  "token": "<TOKEN>",
  "data": {
    "...": "..."
  }
}

响应:

json
{
  "success": true,
  "msg": "success",
  "count": 123
}

count 表示服务接受或恢复的数据条数,不代表所有字段都被覆盖。

恢复前先备份

恢复可能改变当前账号数据。客户端必须让用户明确选择目标账号和文件,并建议先调用 cache/backup 保存当前状态。

文件保存建议 ​

  • 文件名包含账号别名和 UTC 时间;
  • 不要把 Token 放入文件名或 JSON 自定义字段;
  • 将备份放在加密磁盘或离线介质;
  • 恢复失败时保留原文件和错误消息,方便排查。

Released under the CC BY-NC-SA 4.0 License.