专辑

专辑列表

GET /v1/albums

按专辑名排序的全量专辑列表。

参数	默认	说明
limit	20	每页数量，1 ~ 100
offset	0	偏移量

{
  "code": 200,
  "data": {
    "total": 120,
    "limit": 20,
    "offset": 0,
    "items": [ { Album 对象 } ]
  }
}

专辑详情

GET /v1/album/:id

专辑信息 + 完整曲目表（按碟号、曲目号排序）。

{
  "code": 200,
  "data": {
    "id": "alb_xxx",
    "name": "专辑名",
    "year": "2024",
    "cover": "https://...",
    "artists": [{ "id": "art_xxx", "name": "专辑艺术家" }],
    "description": "专辑介绍（Markdown 富文本）",
    "created_at": "2026-01-01T00:00:00+00:00",
    "songs": [
      {
        "id": "s_xxx",
        "title": "歌名",
        "artists": [{ "id": "art_xxx", "name": "歌手" }],
        "album": { "id": "alb_xxx", "name": "专辑名", "year": "2024", "cover": "https://..." },
        "genres": ["Hip-Hop"],
        "cover": "https://...",
        "track": 1,
        "disc": 1
      }
    ]
  }
}

• songs 内每项为歌曲摘要 + track（曲目号）/ disc（碟号）——选中心仪曲目后用其 id 调 /v1/song/:id 获取词曲编、歌词等全部数据
• 多碟专辑按 disc 分组展示即可
• id 不存在时返回 404

示例

curl "https://api.lrcshare.com/v1/albums?limit=30"
curl "https://api.lrcshare.com/v1/album/alb_xxx"