舞萌 DX API 文档

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

API 返回的所有时间均为 UTC 时间，其格式形似 2024-01-01T00:00:00Z，代表北京时间上午 8 时。

API 类型

开发者 API
个人 API
公共 API

注意

个人 API 密钥不能用于开发者 API，开发者 API 密钥不能用于个人 API，请提前根据需求使用对应的 API 密钥。

开发者 API

开发者 API 的所有请求均需要在请求头加入开发者 API 密钥，如果没有，请申请成为开发者获取。

请求头示例：

Authorization: 9sKKK47Ewi20OroB8mhr_0zOiHO3n7jwTaU9atcf2dc=

响应结构

结果将会以 JSON 格式响应：

字段名	类型	说明
success	bool	请求是否成功处理
code	int	HTTP 状态码，通常为 200
message	string	值可空，请求失败理由
data	dict 或 list	值可空，请求结果

POST /api/v0/maimai/player

创建或修改玩家信息。

{ "name": "Ｌｘｎｓ", "rating": 11307, "friend_code": 123456789000000, "trophy_name": "つあメン覚醒電鉄　準急", "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

参数名	类型	说明
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 列表

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

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

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

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

字段名	类型	说明
name	string	游戏内名称
rating	int	玩家 DX Rating
friend_code	int	好友码
trophy	Trophy	仅获取玩家信息返回，称号
trophy_name	string	仅创建玩家信息必选，称号
course_rank	int	段位 ID
class_rank	int	阶级 ID
star	int	搭档觉醒数
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
title	string	曲名
artist	string	艺术家
genre	string	曲目分类
bpm	int	曲目 BPM
map	string	值可空，曲目所属区域
version	int	曲目首次出现版本
rights	string	值可空，曲目版权信息
disabled	bool	值可空，是否被禁用，默认值为 false
difficulties	SongDifficulties	谱面难度

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

字段名	类型	说明
type	SongType	谱面类型
difficulty	LevelIndex	难度
level	string	难度标级
level_value	float	谱面定数
note_designer	string	谱师
version	int	谱面首次出现版本
notes	Notes	值可空，谱面物量

字段名	类型	说明
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	分类标题（日文）

字段名	类型	说明
id	int	收藏品 ID
name	string	收藏品名称
color	string	值可空，仅玩家称号，称号颜色
description	string	值可空，收藏品说明
genre	string	值可空，除玩家称号，收藏品分类（日文）
required	CollectionRequired[]	值可空，收藏品要求

字段名	类型	说明
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	宴会场谱面