歌词

Anniv 歌词 API 提供了灵活的音乐歌词管理策略。

歌词分发

GET /api/lyric

请求参数

返回参数

interface LyricResponse {
  source: LyricLanguage;
  translations: LyricLanguage[];
}

interface LyricLanguage {
  // 歌词语言
  language: LanguageCode;
  // 歌词类型
  type: "text" | "lrc";
  // 歌词内容
  data: string;
  // 贡献者
  contributor: UserIntro;
  // 来源
  source: string;
  // 最后修改
  last_modified: number;
}

涉及到的语言代码（LanguageCode）参考 RFC5646 标准。

错误列表

歌词修改/创建

PATCH /api/lyric

当歌词不存在时，自动创建该歌词。

返回无错误不代表歌词立即可用，可能会有审核环节。因此客户端不应期望创建后立即有可用的歌词，应积极尝试获取。

请求参数

错误代码