top
Top API 返回模型定义.
pydantic-model
Bases: Response
排行榜预览歌曲条目.
| ATTRIBUTE | DESCRIPTION |
|---|---|
rank |
排名位置.
TYPE:
|
rank_type |
排名变化类型.
TYPE:
|
rank_value |
排名变化值文本.
TYPE:
|
id |
歌曲数字 ID.
TYPE:
|
name |
歌曲标题.
TYPE:
|
singer_name |
歌手名称文本.
TYPE:
|
singer_mid |
主歌手 MID.
TYPE:
|
album_mid |
专辑 MID.
TYPE:
|
cover |
封面地址.
TYPE:
|
mv_id |
MV 数字 ID.
TYPE:
|
Fields:
-
rank(int) -
rank_type(int) -
rank_value(str) -
id(int) -
name(str) -
singer_name(str) -
singer_mid(str) -
album_mid(str) -
cover(str) -
mv_id(int)
pydantic-model
Bases: Response
排行榜摘要信息.
| ATTRIBUTE | DESCRIPTION |
|---|---|
id |
排行榜 ID.
TYPE:
|
name |
榜单标题.
TYPE:
|
title_detail |
榜单完整标题.
TYPE:
|
title_sub |
榜单副标题.
TYPE:
|
intro |
榜单简介.
TYPE:
|
period |
榜单期数.
TYPE:
|
update_time |
更新时间.
TYPE:
|
listen_num |
播放量.
TYPE:
|
total_num |
榜单总曲数.
TYPE:
|
songs |
榜单预览歌曲.
TYPE:
|
front_pic_url |
榜单封面.
TYPE:
|
head_pic_url |
榜单头图.
TYPE:
|
h5_jump_url |
H5 跳转地址.
TYPE:
|
special_scheme |
客户端跳转 Scheme.
TYPE:
|
Fields:
-
id(int) -
name(str) -
title_detail(str) -
title_sub(str) -
intro(str) -
period(str) -
update_time(str) -
listen_num(int) -
total_num(int) -
songs(list[TopPreviewSong]) -
front_pic_url(str) -
head_pic_url(str) -
h5_jump_url(str) -
special_scheme(str)
pydantic-model
Bases: Response
排行榜分类.
| ATTRIBUTE | DESCRIPTION |
|---|---|
id |
分类 ID.
TYPE:
|
name |
分类名称.
TYPE:
|
toplist |
分类下的排行榜摘要列表.
TYPE:
|
Fields:
-
id(int) -
name(str) -
toplist(list[TopSummary])
pydantic-model
Bases: Response
排行榜分类响应.
| ATTRIBUTE | DESCRIPTION |
|---|---|
group |
排行榜分类列表.
TYPE:
|
Fields:
-
group(list[TopCategory])
pydantic-model
Bases: Response
排行榜详情响应.
| ATTRIBUTE | DESCRIPTION |
|---|---|
info |
排行榜基础信息.
TYPE:
|
songs |
排行榜歌曲列表. |
song_tags |
歌曲标签列表. |
ext_info_list |
附加信息列表. |
index_info_list |
榜单索引信息列表. |
Fields:
-
info(TopSummary) -
songs(list[Song]) -
song_tags(list[dict]) -
ext_info_list(list[dict]) -
index_info_list(list[dict])
Validators:
-
_coerce_none_list→song_tags,ext_info_list,index_info_list