跳转至

album

models.album

Album API 返回模型定义.

AlbumDetail pydantic-model

Bases: Album

专辑详情页返回的核心专辑信息.

ATTRIBUTE DESCRIPTION
subtitle

专辑副标题.

TYPE: str

time_public

发行日期.

TYPE: str

desc

专辑简介.

TYPE: str

language

专辑语种.

TYPE: str

album_type

专辑类型描述.

TYPE: str

genre

专辑流派文本.

TYPE: str

wikiurl

百科链接.

TYPE: str

Fields:

AlbumCompany pydantic-model

Bases: Response

专辑详情接口中的发行公司信息.

ATTRIBUTE DESCRIPTION
id

公司 ID.

TYPE: int

name

公司名称.

TYPE: str

is_show

是否展示.

TYPE: int

brief

公司简介.

TYPE: str

Fields:

GetAlbumDetailResponse pydantic-model

Bases: Response

专辑详情接口聚合后的响应体.

ATTRIBUTE DESCRIPTION
album

专辑基础信息与补充描述.

TYPE: AlbumDetail

company

发行公司信息.

TYPE: AlbumCompany

singers

专辑署名歌手列表.

TYPE: list[Singer]

Fields:

GetAlbumSongResponse pydantic-model

Bases: Response

专辑歌曲列表接口返回的分页结果.

ATTRIBUTE DESCRIPTION
album_mid

专辑 MID.

TYPE: str

total_num

歌曲总数.

TYPE: int

song_list

当前响应携带的专辑歌曲列表.

TYPE: list[Song]

Fields:

NewAlbumItem pydantic-model

Bases: Album

新碟上架列表中的单张专辑摘要.

ATTRIBUTE DESCRIPTION
singers

专辑署名歌手列表.

TYPE: list[Singer]

release_time

发行日期, 格式通常为 YYYY-MM-DD.

TYPE: str

type

专辑类型.

TYPE: int

area

地区标识.

TYPE: int

genre

流派标识.

TYPE: int

language

语种标识.

TYPE: int

Fields:

GetNewAlbumResponse pydantic-model

Bases: Response

新碟上架接口的响应体.

ATTRIBUTE DESCRIPTION
total

该地区下新碟总数.

TYPE: int

albums

当前页新碟列表.

TYPE: list[NewAlbumItem]

Fields:

AlbumFavWriteResponse pydantic-model

Bases: Response

收藏 / 取消收藏专辑的写操作响应.

ATTRIBUTE DESCRIPTION
result

操作结果码, 0 表示成功.

TYPE: int

failed_album_id

操作失败的专辑 ID 列表, 全部成功时为空.

TYPE: list[int]

Fields:

success property

success: bool

是否操作成功 (result 为 0 且无失败项).