user

models.user

User API 返回模型定义.

UserPlaylistSummary `pydantic-model`

Bases: SongList

用户歌单列表中的单个歌单摘要.

ATTRIBUTE	DESCRIPTION
`id`	歌单 ID. TYPE: `int`
`dirid`	目录 ID. TYPE: `int`
`title`	歌单标题. TYPE: `str`
`picurl`	歌单封面地址. TYPE: `str`
`songnum`	歌曲数量. TYPE: `int`
`create_time`	创建时间戳. TYPE: `int`
`update_time`	更新时间戳. TYPE: `int`
`uin`	创建者 UIN. TYPE: `str`
`nick`	创建者昵称. TYPE: `str`
`desc`	歌单简介. TYPE: `str`
`bigpic_url`	大图封面地址. TYPE: `str`
`album_pic_url`	专辑拼接封面地址. TYPE: `str`
`avatar`	创建者头像. TYPE: `str`
`ident_icon`	身份图标地址. TYPE: `str`
`layer_url`	分层装饰地址. TYPE: `str`
`invalid`	是否失效. TYPE: `bool`
`dir_show`	目录展示标记. TYPE: `int`
`create_fav_cnt`	创建者收藏量. TYPE: `int`
`play_cnt`	播放量. TYPE: `int`
`comment_cnt`	评论数. TYPE: `int`
`op_type`	操作类型标记. TYPE: `int`
`sort_weight`	排序权重. TYPE: `int`

Fields:

id (int)
dirid (int)
title (str)
picurl (str)
desc (str)
songnum (int)
listennum (int | str)
create_time (int)
update_time (int)
uin (str)
nick (str)
bigpic_url (str)
album_pic_url (str)
avatar (str)
ident_icon (str)
layer_url (str)
invalid (bool)
dir_show (int)
create_fav_cnt (int)
play_cnt (int)
comment_cnt (int)
op_type (int)
sort_weight (int)

UserCreatedSonglistResponse `pydantic-model`

Bases: Response

用户创建歌单列表页响应.

ATTRIBUTE	DESCRIPTION
`total`	歌单总数. TYPE: `int`
`playlists`	当前页歌单摘要列表. TYPE: `list[UserPlaylistSummary]`
`deleted_ids`	上游返回的删除歌单 ID 标记. TYPE: `list[int]`
`finished`	是否已经拉取完成. TYPE: `bool`

Fields:

total (int)
playlists (list[UserPlaylistSummary])
deleted_ids (list[int])
finished (bool)

UserFavSonglistItem `pydantic-model`

Bases: SongList

用户收藏歌单列表中的单个条目.

ATTRIBUTE	DESCRIPTION
`id`	歌单 ID. TYPE: `int`
`dirid`	目录 ID. TYPE: `int`
`title`	歌单标题. TYPE: `str`
`picurl`	歌单封面地址. TYPE: `str`
`songnum`	歌曲数量. TYPE: `int`
`uin`	歌单所属用户 UIN. TYPE: `str`
`nickname`	歌单拥有者昵称. TYPE: `str`
`create_time`	创建时间戳. TYPE: `int`
`update_time`	更新时间戳. TYPE: `int`
`order_time`	收藏排序时间戳. TYPE: `int`
`dir_show`	目录展示标记. TYPE: `int`
`dir_type`	目录类型. TYPE: `int`
`edge_mark`	边角标识. TYPE: `str`
`layer_url`	分层装饰地址. TYPE: `str`
`album_pic_url`	专辑拼接封面地址. TYPE: `str`
`op_type`	操作类型标记. TYPE: `int`
`sort_weight`	排序权重. TYPE: `int`
`readtime`	最近读取时间戳. TYPE: `int`

Fields:

id (int)
dirid (int)
title (str)
picurl (str)
desc (str)
songnum (int)
listennum (int | str)
uin (str)
nickname (str)
create_time (int)
update_time (int)
order_time (int)
dir_show (int)
dir_type (int)
edge_mark (str)
layer_url (str)
album_pic_url (str)
op_type (int)
sort_weight (int)
readtime (int)

UserFavSonglistResponse `pydantic-model`

Bases: Response

用户收藏歌单列表页响应.

ATTRIBUTE	DESCRIPTION
`number`	当前页数量或请求数量. TYPE: `int`
`total`	收藏歌单总数. TYPE: `int`
`hasmore`	是否还有更多结果. TYPE: `int`
`hide`	列表是否隐藏. TYPE: `bool`
`playlists`	当前页收藏歌单列表. TYPE: `list[UserFavSonglistItem]`
`deleted_ids`	上游返回的删除歌单 ID 列表. TYPE: `list[int]`
`failed_ids`	拉取失败的歌单 ID 列表. TYPE: `list[int]`

Fields:

number (int)
total (int)
hasmore (int)
hide (bool)
playlists (list[UserFavSonglistItem])
deleted_ids (list[int])
failed_ids (list[int])

UserFavAlbumItem `pydantic-model`

Bases: Album

用户收藏专辑列表中的单个专辑条目.

ATTRIBUTE	DESCRIPTION
`id`	专辑 ID. TYPE: `int`
`mid`	专辑 MID. TYPE: `str`
`name`	专辑名称. TYPE: `str`
`pmid`	专辑封面标识. TYPE: `str`
`songnum`	专辑曲目数. TYPE: `int`
`pubtime`	发布时间戳. TYPE: `int`
`ordertime`	收藏排序时间戳. TYPE: `int`
`status`	状态标记. TYPE: `int`
`loc`	位置或来源标记. TYPE: `int`
`singers`	专辑歌手列表. TYPE: `list[Singer]`

Fields:

id (int)
mid (str)
name (str)
title (str)
subtitle (str)
time_public (str)
pmid (str)
songnum (int)
pubtime (int)
ordertime (int)
status (int)
loc (int)
singers (list[Singer])

UserFavAlbumResponse `pydantic-model`

Bases: Response

用户收藏专辑列表页响应.

ATTRIBUTE	DESCRIPTION
`number`	当前页数量或请求数量. TYPE: `int`
`total`	收藏专辑总数. TYPE: `int`
`hasmore`	是否还有更多结果. TYPE: `int`
`hide`	列表是否隐藏. TYPE: `bool`
`albums`	当前页收藏专辑列表. TYPE: `list[UserFavAlbumItem]`
`failed_album_ids`	拉取失败的专辑 ID 列表. TYPE: `list[int]`

Fields:

number (int)
total (int)
hasmore (int)
hide (bool)
albums (list[UserFavAlbumItem])
failed_album_ids (list[int])

UserInfoCard `pydantic-model`

Bases: Response

用户音乐基因页头部卡片信息.

ATTRIBUTE	DESCRIPTION
`head_url`	头像地址. TYPE: `str`
`nick_name`	昵称. TYPE: `str`
`signature`	个性签名. TYPE: `str`
`encryption_account`	加密账号标识. TYPE: `str`
`preferences`	偏好信息块. TYPE: `dict[str, Any]`

Fields:

head_url (str)
nick_name (str)
signature (str)
encryption_account (str)
preferences (dict[str, Any])

ListeningReport `pydantic-model`

Bases: Response

用户听歌报告摘要.

ATTRIBUTE	DESCRIPTION
`report`	听歌报告分块列表. TYPE: `list[dict[str, Any]]`

Fields:

report (list[dict[str, Any]])

UserMusicGeneResponse `pydantic-model`

Bases: Response

用户音乐基因视图响应.

ATTRIBUTE	DESCRIPTION
`user_info_card`	用户卡片信息. TYPE: `UserInfoCard`
`listening_report`	听歌报告摘要. TYPE: `ListeningReport`
`sort_array`	排序提示数组. TYPE: `list[int]`
`is_visit_account`	是否访问本人账号. TYPE: `bool`

Fields:

user_info_card (UserInfoCard)
listening_report (ListeningReport)
sort_array (list[int])
is_visit_account (bool)

UserHomepageBaseInfo `pydantic-model`

Bases: Response

用户主页头部基础信息.

ATTRIBUTE	DESCRIPTION
`encrypted_uin`	加密 UIN. TYPE: `str`
`name`	用户名. TYPE: `str`
`avatar`	头像地址. TYPE: `str`
`background_image`	背景图地址. TYPE: `str`
`user_type`	用户类型标记. TYPE: `int`

Fields:

encrypted_uin (str)
name (str)
avatar (str)
background_image (str)
user_type (int)

UserHomepageResponse `pydantic-model`

Bases: Response

用户主页视图响应.

ATTRIBUTE	DESCRIPTION
`base_info`	主页头部基础信息. TYPE: `UserHomepageBaseInfo`
`singer`	主页关联歌手信息. TYPE: `dict[str, Any]`
`is_followed`	当前账号是否已关注. TYPE: `int`
`tab_detail`	主页标签页附加信息. TYPE: `dict[str, Any]`

Fields:

base_info (UserHomepageBaseInfo)
singer (dict[str, Any])
is_followed (int)
tab_detail (dict[str, Any])

VipUserInfo `pydantic-model`

Bases: Response

VIP 信息响应中的用户权益摘要块.

ATTRIBUTE	DESCRIPTION
`buy_url`	开通入口地址. TYPE: `str`
`my_vip_url`	我的会员页地址. TYPE: `str`
`score`	会员积分. TYPE: `int`
`expire`	到期时间戳. TYPE: `int`
`music_level`	音乐等级. TYPE: `int`

Fields:

buy_url (str)
my_vip_url (str)
score (int)
expire (int)
music_level (int)

UserVipInfoResponse `pydantic-model`

Bases: Response

VIP 信息视图响应.

ATTRIBUTE	DESCRIPTION
`auto_down`	自动下载开关状态. TYPE: `int`
`can_renew`	是否可续费. TYPE: `int`
`max_dir_num`	最大歌单数量. TYPE: `int`
`max_song_num`	最大歌曲数量. TYPE: `int`
`song_limit_msg`	歌曲上限提示文案. TYPE: `str`
`userinfo`	用户权益摘要. TYPE: `VipUserInfo`

Fields:

auto_down (int)
can_renew (int)
max_dir_num (int)
max_song_num (int)
song_limit_msg (str)
userinfo (VipUserInfo)

RelationUser `pydantic-model`

Bases: Response

关注或粉丝列表中的单个用户条目.

ATTRIBUTE	DESCRIPTION
`mid`	用户 MID. TYPE: `str`
`enc_uin`	加密 UIN. TYPE: `str`
`name`	用户名称. TYPE: `str`
`desc`	描述文案. TYPE: `str`
`avatar_url`	头像地址. TYPE: `str`
`fan_num`	粉丝数. TYPE: `int`
`is_follow`	当前账号是否已关注. TYPE: `bool`

Fields:

mid (str)
enc_uin (str)
name (str)
desc (str)
avatar_url (str)
fan_num (int)
is_follow (bool)

UserRelationListResponse `pydantic-model`

Bases: Response

关注关系分页列表响应.

ATTRIBUTE	DESCRIPTION
`total`	总数量. TYPE: `int`
`users`	当前页用户列表. TYPE: `list[RelationUser]`
`has_more`	是否还有更多结果. TYPE: `bool`
`last_pos`	下一页游标. TYPE: `str`
`msg`	附加消息. TYPE: `str`
`lock_flag`	锁定状态标记. TYPE: `int`
`lock_msg`	锁定提示文案. TYPE: `str`

Fields:

total (int)
users (list[RelationUser])
has_more (bool)
last_pos (str)
msg (str)
lock_flag (int)
lock_msg (str)

Validators:

_coerce_users → users

FriendEntry `pydantic-model`

Bases: Response

好友列表中的单个好友条目.

ATTRIBUTE	DESCRIPTION
`encrypt_uin`	加密 UIN. TYPE: `str`
`user_name`	用户名. TYPE: `str`
`avatar_url`	头像地址. TYPE: `str`
`is_follow`	当前账号是否已关注. TYPE: `bool`

Fields:

encrypt_uin (str)
user_name (str)
avatar_url (str)
is_follow (bool)

UserFriendListResponse `pydantic-model`

Bases: Response

好友列表视图响应.

ATTRIBUTE	DESCRIPTION
`friends`	当前页好友列表. TYPE: `list[FriendEntry]`
`has_more`	是否还有更多结果. TYPE: `bool`

Fields:

friends (list[FriendEntry])
has_more (bool)

UserFavMvItem `pydantic-model`

Bases: MV

用户收藏 MV 列表中的单个条目.

ATTRIBUTE	DESCRIPTION
`id`	MV ID. TYPE: `int`
`vid`	MV VID. TYPE: `str`
`name`	MV 名称. TYPE: `str`
`title`	MV 标题. TYPE: `str`
`picurl`	MV 封面地址. TYPE: `str`
`playcount`	播放量. TYPE: `int`
`publish_date`	发布时间. TYPE: `int`
`singer_id`	歌手 ID. TYPE: `int`
`singer_mid`	歌手 MID. TYPE: `str`
`singer_name`	歌手名称. TYPE: `str`
`status`	状态标记. TYPE: `int`

Fields:

id (int)
vid (str)
type (int)
name (str)
title (str)
picurl (str)
playcount (int)
publish_date (int)
singer_id (int)
singer_mid (str)
singer_name (str)
status (int)

UserFavMvResponse `pydantic-model`

Bases: Response

用户收藏 MV 列表视图响应.

ATTRIBUTE	DESCRIPTION
`code`	返回码. TYPE: `int`
`sub_code`	子返回码. TYPE: `int`
`msg`	附加消息. TYPE: `str`
`mv_list`	当前页收藏 MV 列表. TYPE: `list[UserFavMvItem]`

Fields:

code (int)
sub_code (int)
msg (str)
mv_list (list[UserFavMvItem])

user

models.user

UserPlaylistSummary pydantic-model

UserCreatedSonglistResponse pydantic-model

UserFavSonglistItem pydantic-model

UserFavSonglistResponse pydantic-model

UserFavAlbumItem pydantic-model

UserFavAlbumResponse pydantic-model

UserInfoCard pydantic-model

ListeningReport pydantic-model

UserMusicGeneResponse pydantic-model

UserHomepageBaseInfo pydantic-model

UserHomepageResponse pydantic-model

VipUserInfo pydantic-model

UserVipInfoResponse pydantic-model

RelationUser pydantic-model

UserRelationListResponse pydantic-model

FriendEntry pydantic-model

UserFriendListResponse pydantic-model

UserFavMvItem pydantic-model

UserFavMvResponse pydantic-model

UserPlaylistSummary `pydantic-model`

UserCreatedSonglistResponse `pydantic-model`

UserFavSonglistItem `pydantic-model`

UserFavSonglistResponse `pydantic-model`

UserFavAlbumItem `pydantic-model`

UserFavAlbumResponse `pydantic-model`

UserInfoCard `pydantic-model`

ListeningReport `pydantic-model`

UserMusicGeneResponse `pydantic-model`

UserHomepageBaseInfo `pydantic-model`

UserHomepageResponse `pydantic-model`

VipUserInfo `pydantic-model`

UserVipInfoResponse `pydantic-model`

RelationUser `pydantic-model`

UserRelationListResponse `pydantic-model`

FriendEntry `pydantic-model`

UserFriendListResponse `pydantic-model`

UserFavMvItem `pydantic-model`

UserFavMvResponse `pydantic-model`