提示：

不提供谱面详细信息查询，请使用官方API。

API Version: 0.3 最后更新于：2022/08/30

谱面文件、图片地址：https://osumirror.desu.life:60004/Songs/{beatmapset id}/

注：无缓存时，将会返回404。

*下列API已转为私有API，不再向公众开放。

API地址：https://api.desu.life/

API使用URL parameters (query strings) 传递参数。请求方法为GET。

服务器时间（仅用于判断API状态）：

/time

参数：

• verify – 一串随机字符串，由客户端生成，服务器返回相同结果。

返回值：

{“code”:200,”message”:”2022/2/24 22:48:08″,”verify”:””}

查询：

/query

用于查询谱面缓存状态

参数：

• beatmapsetid – 需输入sid。
• beatmapid – 需输入bid，在有sid传入的情况下，此项参数会被忽略。
• verify – 一串随机字符串，由客户端生成，服务器返回相同结果。

返回值：

{“code”:200,”message”:”\\Archives\\example.osz”,”verify”:””}

返回值（code）说明：

• 200：成功获取下载路径，下载路径需要message与https://om1.desu.life/拼接之后访问。
• 404：谱面未被缓存。
• 500：服务器内部发生错误，无法进行处理。

缓存至服务器：

/cache

将铺面缓存至服务器，如已缓存则返回与/query相同的信息，否则请参照返回值说明。

参数：

• beatmapsetid – 需输入sid。
• beatmapid – 需输入bid，在有sid传入的情况下，此项参数会被忽略。
• verify – 一串随机字符串，由客户端生成，服务器返回相同结果。

返回值：

{“code”:202,”message”:”15014182/17805178 84%”,”verify”:””}

返回值（code）说明：

• 200：已被缓存，且返回下载路径，下载路径需要message与https://om1.desu.life/拼接之后访问。
• 201：已成功缓存，且返回下载路径。下载路径需要message与https://om1.desu.life/拼接之后访问。
• 202：此请求在早些时候已被后端接受，正在处理。（下载进度格式为：已下载的内容大小/总大小 进度百分比）
• 403：谱面无法被缓存。
• 500：服务器内部发生错误，无法进行处理。