分享管理

Anniv 基于信息导出格式实现单曲、专辑和播放列表的分享。

错误一览

错误代码	详情
`105000`	用户分享数已达上限
`105001`	分享链接不存在

该接口无需用户登录。

GET /api/share

参数名	类型	详情
`id`	`string`	分享链接的 ID

返回分享链接的实际内容，结构为 ExportedPlaylist。

错误代码	详情
`105001`	分享链接不存在

GET /api/share/

返回当前用户创建的所有分享链接列表。

参数名	类型	详情
`id`	`string`	分享链接的 ID
`date`	`timestamp`	分享创建日期

创建分享链接时，客户端需要提供待分享资源的元数据和供被分享人播放音乐的分享 Token。Anniv 负责记录用户提供的上述信息，并存储一份用户指定播放列表的快照。

POST /api/share

参数名	类型	详情
`info`	`ExportedPlaylistInfo`	分享的必要信息
`metadata`	`ExportedPlaylistMetadata.metadata`	可选的元数据。当未指定时，元数据由 `Anniv` 提供
`albums`	`Record<AlbumIdentifier, Id['id']>`	待签发专辑与 Annil Token 的对应关系

请求成功时，返回分享链接的短部。

错误代码	详情
`105000`	用户分享数已达上限

DELETE /api/share

参数名	类型	详情
`id`	`string`	待删除分享链接的 ID

错误代码	详情
`902000`	分享链接不存在