上传缓存

上传缓存接口管理已经生成的缓存快照。它适合网络不稳定或需要在多个受信设备之间转移数据的场景。

获取缓存列表

POST /upload-cache/get

{
  "token": "<TOKEN>"
}

响应：

{
  "success": true,
  "msg": "success",
  "data": ["snapshot-001", "snapshot-002"]
}

上传缓存

POST /upload-cache/upload

{
  "token": "<TOKEN>",
  "indexName": "snapshot-001",
  "SGWCMAID": "<QR_TEXT>",
  "customAimeUrl": ""
}

字段	类型	说明
indexName	string	要上传的缓存索引
SGWCMAID	string	页面要求的访问码/二维码文本
customAimeUrl	string	可选自定义服务地址

响应中的 data 和 music 为服务端处理结果，客户端应展示 msg 并保留失败信息。

删除缓存

POST /upload-cache/del

{
  "token": "<TOKEN>",
  "indexName": "snapshot-001"
}

删除后返回新的列表或删除结果。该操作不可逆，调用前应二次确认。

下载缓存文件

POST /upload-cache/get-file

{
  "token": "<TOKEN>",
  "indexName": "snapshot-001"
}

响应中的 data 由服务端定义，客户端应按 Content-Type 和 JSON 字段处理，不要假设所有版本返回同一种结构。