舞萌 DX API 文档

在本查分器中，同一首曲目的标准、DX 谱面的曲目 ID 一致，不存在大于 10000 的曲目 ID（如有，请在请求前对 10000 取余处理）。宴会场曲目为例外，不分标准、DX 谱面，曲目 ID 大于 100000。

API 类型

开发者 API
个人 API
公共 API

开发者 API

POST /api/v0/maimai/player

创建或修改玩家信息。

权限

allow_third_party_write_data

请求体

Player

请求示例

{
  "name": "Ｌｘｎｓ",
  "rating": 11307,
  "friend_code": 123456789000000,
  "trophy": {
    "id": 300022
  },
  "course_rank": 0,
  "class_rank": 0,
  "star": 82,
  "icon": {
    "id": 200201
  },
  "name_plate": {
    "id": 200201
  },
  "frame": {
    "id": 300101
  }
}

GET /api/v0/maimai/player/{friend_code}

获取玩家信息。

权限

allow_third_party_fetch_player

URL 参数

参数名	类型	说明
friend_code	int	好友码

参数名	类型	说明
song_id	int	曲目 ID，与 song_name 冲突
song_name	string	曲名，与 song_id 冲突
level_index	LevelIndex	难度
song_type	SongType	谱面类型

字段名	类型	说明
standard_total	int	旧版本谱面 Best 35 总分
dx_total	int	现版本谱面 Best 15 总分
standard	Score[]	旧版本谱面 Best 35 列表
dx	Score[]	现版本谱面 Best 15 列表
standard_selections	Score[]	旧版本谱面 Selection 10 列表
dx_selections	Score[]	现版本谱面 Selection 10 列表

参数名	类型	说明
song_id	int	曲目 ID
song_type	SongType	谱面类型
level_index	LevelIndex	难度

参数名	类型	说明
friend_code	int	好友码
collection_type	string	收藏品类型，值为 trophy、icon、plate 或 frame
collection_id	int	收藏品 ID

参数名	类型	说明
version	int	值可空，游戏版本，默认值为 25500
notes	bool	值可空，是否包含谱面物量，默认值为 false

字段名	类型	说明
songs	Song[]	曲目列表
genres	Genre[]	乐曲分类列表
versions	Version[]	曲目版本列表

参数名	类型	说明
version	int	值可空，游戏版本，默认值为 25500
required	bool	值可空，是否包含曲目需求，默认值为 false

字段名	类型	说明
trophies	Collection[]	仅收藏品类型为 trophy，称号列表
icons	Collection[]	仅收藏品类型为 icon，头像列表
plates	Collection[]	仅收藏品类型为 plate，姓名框列表
frames	Collection[]	仅收藏品类型为 frame，背景列表

字段名	类型	说明
name	string	游戏内名称
rating	int	玩家 DX Rating
friend_code	int	好友码
course_rank	int	段位 ID
class_rank	int	阶级 ID
star	int	搭档觉醒数
trophy	Trophy	仅上传时可空，称号
icon	Icon	值可空，头像
name_plate	NamePlate	值可空，姓名框
frame	Frame	值可空，背景
upload_time	string	仅获取玩家信息返回，玩家被同步时的 UTC 时间

字段名	类型	说明
total	int	总 DX Rating
standard	int	旧版本谱面总 DX Rating
dx	int	现版本谱面总 DX Rating
date	string	日期

字段名	类型	说明
id	int	曲目 ID
song_name	string	仅获取 Score 时返回，曲名
level	string	仅获取 Score 时返回，难度标级，如 14+
level_index	LevelIndex	难度
achievements	float	达成率
fc	FCType	值可空，FULL COMBO 类型
fs	FSType	值可空，FULL SYNC 类型
dx_score	int	DX 分数
dx_star	int	DX 星级，最大值为 5
dx_rating	float	仅获取 Score 时返回，DX Rating，计算时需要向下取整
rate	RateType	仅获取 Score 时返回，评级类型
type	SongType	谱面类型
play_time	string	值可空，游玩的 UTC 时间，精确到分钟；上传时忽略，仅通过 HTML 上传写入
upload_time	string	仅获取 Score 时返回，成绩被同步时的 UTC 时间
last_played_time	string	仅获取成绩列表、获取最佳成绩时返回，谱面最后游玩的 UTC 时间

字段名	类型	说明
id	int	曲目 ID
title	string	曲名
artist	string	艺术家
genre	string	曲目分类
bpm	int	曲目 BPM
map	string	值可空，曲目所属区域
version	int	曲目首次出现版本
rights	string	值可空，曲目版权信息
locked	bool	值可空，是否需要解锁，默认值为 false
disabled	bool	值可空，是否被禁用，默认值为 false
difficulties	SongDifficulties	谱面难度

字段名	类型	说明
standard	SongDifficulty[]	曲目标准谱面难度列表
dx	SongDifficulty[]	曲目 DX 谱面难度列表
utage	SongDifficultyUtage[]	可选，宴会场曲目谱面难度列表

字段名	类型	说明
kanji	string	谱面属性
description	string	谱面描述
is_buddy	bool	是否为 BUDDY 谱面
notes	Notes 或 BuddyNotes	值可空，谱面物量

字段名	类型	说明
total	int	总物量
tap	int	TAP 物量
hold	int	HOLD 物量
slide	int	SLIDE 物量
touch	int	TOUCH 物量
break	int	BREAK 物量

字段名	类型	说明
id	int	内部 ID
title	string	分类标题
genre	string	分类标题（日文）

字段名	类型	说明
difficulties	LevelIndex[]	值可空，要求的谱面难度，长度为 0 时代表任意难度
rate	RateType	值可空，要求的评级类型
fc	FCType	值可空，要求的 FULL COMBO 类型
fs	FSType	值可空，要求的 FULL SYNC 类型
songs	CollectionRequiredSong[]	值可空，要求的曲目列表
completed	bool	值可空，要求是否全部完成

字段名	类型	说明
id	int	收藏品分类 ID
title	string	分类标题
genre	string	分类标题（日文）

值	类型	说明
fsdp	string	FDX+
fsd	string	FDX
fsp	string	FS+
fs	string	FS
sync	string	SYNC PLAY

值	类型	说明
sssp	string	SSS+
sss	string	SSS
ssp	string	SS+
ss	string	SS
sp	string	S+
s	string	S
aaa	string	AAA
aa	string	AA
a	string	A
bbb	string	BBB
bb	string	BB
b	string	B
c	string	C
d	string	D

值	类型	说明
standard	string	标准谱面
dx	string	DX 谱面
utage	string	宴会场谱面

值	类型	说明
normal	string	普通
bronze	string	铜
silver	string	银
gold	string	金
rainbow	string	虹