数据缓存
缓存接口用于下载账号数据快照和恢复 JSON 快照。
下载普通缓存
http
POST /cache/backupjson
{
"token": "<TOKEN>"
}响应中的 data 为服务返回的备份对象:
json
{
"success": true,
"msg": "success",
"data": { "...": "..." }
}客户端应把完整响应中的 data 保存为 JSON,并记录账号名称、导出时间和版本。
恢复缓存
http
POST /cache/restorejson
{
"token": "<TOKEN>",
"data": {
"...": "..."
}
}响应:
json
{
"success": true,
"msg": "success",
"count": 123
}count 表示服务接受或恢复的数据条数,不代表所有字段都被覆盖。
恢复前先备份
恢复可能改变当前账号数据。客户端必须让用户明确选择目标账号和文件,并建议先调用 cache/backup 保存当前状态。
文件保存建议
- 文件名包含账号别名和 UTC 时间;
- 不要把 Token 放入文件名或 JSON 自定义字段;
- 将备份放在加密磁盘或离线介质;
- 恢复失败时保留原文件和错误消息,方便排查。
