专辑元数据
Anniv 提供对元数据仓库中元数据进行索引的能力。
结构定义
type AlbumTitle = { album_title: string };
type TrackInfoWithAlbum = TrackIdentifier & Required<TrackInfo> & AlbumTitle;
获取 Tag 列表
GET /api/meta/tags
返回
返回包含所有 Tag 的数组，类型为 TagInfo[] 。
专辑信息
通过 album_id 获得专辑元数据的接口。支持同时获取多张专辑的元数据信息。
Endpoint
GET /api/meta/album
请求参数
| 参数名 | 说明 |
|---|---|
id[] | 待获取元数据的专辑 ID 列表 |
返回
返回以 album_id 为键，专辑元数据或空为值的 Object。
当查询成功时，值为专辑的 AlbumDetail，否则为 null。
按 Tag 检索专辑
通过 Tag 检索归属于该 Tag 下的专辑列表。
该接口属于检索接口，标签使用「向上合并」的语义。即计算专辑标签时，需要取专辑内所有专辑标签、光盘标签和音轨标签的并集。具体定义见 专辑信息 - 标签。
Endpoint
GET /api/meta/albums/by-tag
参数
| 参数名 | 类型 | 说明 |
|---|---|---|
tag | string | Tag 名 |
recursive | boolean | 是否递归检索子 Tag 所包含专辑 |
返回
AlbumDetail[]
错误列表
| 错误代码 | 详情 |
|---|---|
902000 | Tag 不存在 |
获取 Tag 关系
GET /api/meta/tag-graph
返回
返回 tag 依赖关系的邻接表，类型表示为 Record<string, string[]> 。
Key-Value 对应的是标签与其所包含的子标签。字符串格式为 <EDITION>:<NAME>，标签类型不可省略。