需要用到的软件知识

acronym = 比赛名，由裁判提供

[{"approved" : "1", // 4 = loved, 3 = qualified, 2 = approved, 1 = ranked, 0 = pending, -1 = WIP, -2 = graveyard 
"approved_date" : "2013-07-02 01:01:12", // ranked日期, 时区为UTC+8 
"last_update" : "2013-07-06 16:51:22", // 最后更新日期，时区同上。 如果谱面被Unranked之后Reranked，该日期可能晚于上面的日期。
"artist" : "Luxion",
"beatmap_id" : "252002", // 每个难度的Beatmap_ID
"beatmapset_id" : "93398", // 所有难度的BeatmapSet_ID
"bpm" : "196",
"creator" : "RikiH_",
"difficultyrating" : "5.59516", // 游戏中和网站上的难度星数
"diff_size" : "4", // CS
"diff_overall" : "6", // OD
"diff_approach" : "7", // AR
"diff_drain" : "6", // HP
"hit_length" : "113", // 第一个note到最后一个note的间隔（不计算breaks）
"source" : "BMS",
"genre_id" : "1", // 0 = any, 1 = unspecified, 2 = video game, 3 = anime, 4 = rock, 5 = pop, 6 = other, 7 = novelty, 9 = hip hop, 10 = electronic (note that there's no 8) 
"language_id" : "5", // 0 = any, 1 = other, 2 = english, 3 = japanese, 4 = chinese, 5 = instrumental, 6 = korean, 7 = french, 8 = german, 9 = swedish, 10 = spanish, 11 = italian
"title" : "High-Priestess", // 歌曲名称
"total_length" : "145", // 第一个note到最后一个note的间隔（计算breaks） 
"version" : "Overkill", // 难度名
"file_md5" : "c8f08438204abfcdd1a748ebfae67421", // 谱面文件（不知道是.osz还是.osu）的MD5哈希值
"mode" : "0", // 模式, 
"tags" : "melodious long", // tags
"favourite_count" : "121", // 被收藏的次数。特别的，该条目采用英式英语，而不是美式英语（favorite_count）
"playcount" : "9001", // 被玩（。）的次数
"passcount" : "1337", // 被pass的次数（玩家没有fail或者retry）
"max_combo" : "2101" // 最大combo数
}, { ... }, ...]

[{"user_id" : "1",
"username" : "User name",
"count300" : "1337", 
"count100" : "123", 
"count50" : "69", 
"playcount" : "42", // 以上四条为所有Ranked，Approved，Loved谱面中的计数
"ranked_score" : "666666", // 所有Ranked，Approved，Loved谱面中的最高分计数
"total_score" : "999999998", // 所有Ranked，Approved，Loved谱面中所有成绩的总分。
"pp_rank" : "2442",
"level" : "50.5050",
"pp_raw" : "3113", // 不活跃的玩家PP值是0，以将他们排除出PP榜单
"accuracy" : "98.1234",
"count_rank_ss": "54",
"count_rank_s" : "81", // 获得的SS S A的数目
"count_rank_a" : "862", 
"country" : "DE", // 使用ISO3166-1 alpha-2国家命名规范。 参考http://en.wikipedia.org/wiki/ISO_3166-1_alpha-2/wiki/ISO_3166-1_alpha-2
"pp_country_rank":"1337", // 国内的PP排名
"events" : [{ // 记录这个用户上传的成绩【但是实际应用并没有获取到】
"display_html": "<img src='\/images\/A_small.png'\/>...",//评级对应的图片
"beatmap_id": "222342",
"beatmapset_id": "54851",
"date": "2013-07-07 22:34:04",
"epicfactor": "1" // 这个成绩有多么的“史诗级”，取值范围是1-32
}, { ... }, ...] 
}]

[{"score" : "1234567",
"username" : "User name",
"count300" : "300",
"count100" : "50",
"count50" : "10",
"countmiss" : "1",
"maxcombo" : "321",
"countkatu" : "10",
"countgeki" : "50",
"perfect" : "0", // 只有取得了地图的最大cb时，该值为1 
"enabled_mods" : "76", // 具体参见枚举
"user_id" : "1",
"date" : "2013-06-22 9:11:16",
"rank" : "SH",
"pp" : "1.3019" //4位小数
}, 

{...}, 

...]

enum Mods{
None = 0,
NoFail = 1,
Easy = 2,
//NoVideo = 4, 
//在2012年以前，关闭背景视频进行游戏是一个Mod，后被删除。
//在2017年下半年有玩家使用触屏打破PP记录后ppy重新启用这个位置，设为Touch Device Mod，对触屏PP大幅度削弱。
Touch Device = 4,
Hidden = 8,
HardRock = 16,
SuddenDeath = 32,
DoubleTime = 64,
Relax = 128,
HalfTime = 256,
Nightcore = 512, // 只和DT搭配使用。例如带NC的成绩，返回576（512+64）
Flashlight = 1024,
Autoplay = 2048,
SpunOut = 4096,
Relax2 = 8192,// Autopilot？
Perfect = 16384,
Key4 = 32768,
Key5 = 65536,
Key6 = 131072,
Key7 = 262144,
Key8 = 524288,
keyMod = Key4 | Key5 | Key6 | Key7 | Key8,
FadeIn = 1048576,
Random = 2097152,
LastMod = 4194304,
FreeModAllowed = NoFail | Easy | Hidden | HardRock | SuddenDeath | Flashlight | FadeIn | Relax | Relax2 | SpunOut | keyMod,
Key9 = 16777216,
Key10 = 33554432,
Key1 = 67108864,
Key3 = 134217728,
Key2 = 268435456
}

[{"beatmap_id" : "222342",
"score" : "1234567",
"username" : "User name",
"maxcombo" : "321",
"count300" : "300",
"count100" : "50",
"count50" : "10",
"countmiss" : "1",
"countkatu" : "10",
"countgeki" : "50",
"perfect" : "0", //只有取得了地图的最大cb时，该值为1 
"enabled_mods" : "76", //具体参见前文枚举
"user_id" : "1",
"date" : "2013-06-22 9:11:16",
"rank" : "SH",
"pp" : "1.3019" //四位小数
},
{ ... },
...]

[{"match":{"match_id" : "1936471",
"name" : "Marcin's game",
"start_time" : "2013-10-06 03:34:54",
"end_time" : null // 并不支持——永远是null },
"games":[{
"game_id" : "45668898",
"start_time" : "2013-10-06 03:36:27",
"end_time" : "2013-10-06 03:40:01",
"beatmap_id" : "181717",
"play_mode" : "0", // standard = 0, taiko = 1, ctb = 2, o!m = 3 
"match_type" : "0", // 并不支持
"scoring_type" : "0", // 胜利条件：score = 0, accuracy = 1, combo = 2, score v2 = 3
"team_type" : "0", // 比赛模式：Head to head = 0, Tag Co-op = 1, Team vs = 2, Tag Team vs = 3 
"mods" : "0", // 房间使用的Mod，参看前文 
"scores" : [{"slot" : "0", // 从0开始，按玩家所在的玩家位排列 
"team" : "0", // 未开启队伍模式则为0, 1为蓝队，2为红队
"user_id" : "722665",
"score" : "3415874",
"maxcombo" : "411",
"rank" : "0", //并不支持
"count50" : "0",
"count100" : "11",
"count300" : "425",
"countmiss" : "1",
"countgeki" : "67",
"countkatu" : "9",
"perfect" : "0", //最大CB
"pass" : "1" // 如果玩家在结尾失败了则为0，pass或者复活了则为1},
{ ... } ...] }, 
{ ... }, ...] 
}]

{"content":"喵喵喵","encoding":"base64"}

POST https://osu.ppy.sh/oauth/clients
X-CSRF-TOKEN: {Your CSRF Token here}
Content-Type: application/json
Cookie: osu_session={Your osu_session in cookies};

{
    "name": "Example client",
    "redirect": "https://example.com/callback"
}

{
  "user_id": 12345,
  "name": "Example client",
  "secret": "****************************",
  "redirect": "https:\/\/example.com\/callback",
  "personal_access_client": false,
  "password_client": false,
  "revoked": false,
  "updated_at": "YYYY-mm-dd HH:ii:ss",
  "created_at": "YYYY-mm-dd HH:ii:ss",
  "id": 1
}

POST https://osu.ppy.sh/oauth/token
Content-Type: application/x-www-form-urlencoded

grant_type=authorization_code
&client_id={$client_id}
&client_secret={$client_secret}
&redirect_uri={$redirect_uri}
&code={$code}

{
    "token_type": "Bearer",
    "expires_in": 86400,
    "access_token": "****",
    "refresh_token": "****"
}

{
    "id": 9367540,
    "username": "kj415j45",
    "join_date": "2016-12-04T03:43:39+00:00",
    "country": {
        "code": "CN",
        "name": "China"
    },
    "avatar_url": "https://a.ppy.sh/9367540?1505577694.jpeg",
    "is_supporter": false,
    "has_supported": true,
    "is_gmt": false,
    "is_qat": false,
    "is_bng": false,
    "is_bot": false,
    "is_active": true,
    "interests": "osu!, code, steam",
    "occupation": "Student",
    "title": null,
    "location": "SWU(RongChang), China",
    "last_visit": "2019-02-10T07:51:00+00:00",
    "twitter": "kj415j45",
    "lastfm": null,
    "skype": "QQ: 919815238",
    "website": "https://kj415j45.space",
    "discord": "kj415j45#3309",
    "playstyle": ["keyboard", "tablet"],
    "playmode": "osu",
    "pm_friends_only": false,
    "post_count": 24,
    "profile_colour": null,
    "profile_order": ["me", "top_ranks", "recent_activity", "historical", "medals", "beatmaps", "kudosu"],
    "cover_url": "https://assets.ppy.sh/user-profile-covers/9367540/02ac0c9670be6d3ad00529245b53b0104384a6887fcf8bfe92ed68ecd2b28312.jpeg",
    "cover": {
        "custom_url": "https://assets.ppy.sh/user-profile-covers/9367540/02ac0c9670be6d3ad00529245b53b0104384a6887fcf8bfe92ed68ecd2b28312.jpeg",
        "url": "https://assets.ppy.sh/user-profile-covers/9367540/02ac0c9670be6d3ad00529245b53b0104384a6887fcf8bfe92ed68ecd2b28312.jpeg",
        "id": null
    },
    "kudosu": {
        "total": 0,
        "available": 0
    },
    "max_blocks": 25,
    "max_friends": 250,
    "account_history": [],
    "active_tournament_banner": [],
    "badges": [
        {
            "awarded_at": "2018-04-03T04:29:52+00:00",
            "description": "Outstanding contribution and organization of the Chinese localisation project for osu!, osu!wiki and osu!lazer",
            "image_url": "https://assets.ppy.sh/profile-badges/contributor.jpg"
        }, {...}, ...
    ],
    "favourite_beatmapset_count": [52],
    "follower_count": [164],
    "graveyard_beatmapset_count": [0],
    "loved_beatmapset_count": [0],
    "monthly_playcounts": [
        {
            "start_date": "2016-12-01",
            "count": 269
        }, {...}, ...
    ],
    "page": {
        "html": "",
        "raw": ""
    },
    "previous_usernames": [],
    "ranked_and_approved_beatmapset_count": [0],
    "replays_watched_counts": [
        {
            "start_date": "2017-07-01",
            "count": 1
        }, {...}, ...
    ],
    "scores_first_count": [0],
    "statistics": {
        "level": {
            "current": 83,
            "progress": 59
        },
        "pp": 1826.98,
        "pp_rank": 146494,
        "ranked_score": 1647237303,
        "hit_accuracy": 89.6849,
        "play_count": 4768,
        "play_time": 365093,
        "total_score": 3861238114,
        "total_hits": 1140103,
        "maximum_combo": 1089,
        "replays_watched_by_others": 3,
        "is_ranked": true,
        "grade_counts": {
            "ss": 9,
            "ssh": 4,
            "s": 123,
            "sh": 18,
            "a": 196
        },
        "rank": {
            "global": 146494,
            "country": 3752
        },
        "scoreRanks": {
            "XH": 4,
            "SH": 18,
            "X": 9,
            "S": 123,
            "A": 196
        }
    },
    "support_level": 0,
    "unranked_beatmapset_count": [0],
    "user_achievements": [
        {
            "achieved_at": "2019-02-09T05:45:17+00:00",
            "achievement_id": 47
        }, {...}, ...
    ]
}

POST https://osu.ppy.sh/oauth/token
Content-Type: application/x-www-form-urlencoded

grant_type=refresh_token
&client_id=1
&client_secret=*************
&refresh_token=**********************

{
    "token_type": "Bearer",
    "expires_in": 86400,
    "access_token": "****",
    "refresh_token": "****"
}

GET https://osu.ppy.sh/oauth/clients
X-CSRF-TOKEN: {Your CSRF Token here}
Content-Type: application/json

[
    {
      "user_id": 9367540,
      "name": "Example client",
      "secret": "****************************",
      "redirect": "https:\/\/example.com\/callback",
      "personal_access_client": false,
      "password_client": false,
      "revoked": false,
      "updated_at": "YYYY-mm-dd HH:ii:ss",
      "created_at": "YYYY-mm-dd HH:ii:ss",
      "id": 1
    },{},...
]

PUT https://osu.ppy.sh/oauth/clients/{client-id}
X-CSRF-TOKEN: {Your CSRF Token here}
Content-Type: application/json

{
    "name": "Example client",
    "redirect": "https://example.com/callback"
}

{
  "user_id": 9367540,
  "name": "Example client",
  "redirect": "https:\/\/example.com\/callback",
  "personal_access_client": false,
  "password_client": false,
  "revoked": false,
  "updated_at": "YYYY-mm-dd HH:ii:ss",
  "created_at": "YYYY-mm-dd HH:ii:ss",
  "id": 1
}

返回：

需要注意的是，撤销一个已经撤销的Client也会返回200，而撤销其他人的Client返回的是404而不是401。

### 5.3 osu!游戏更新信息接口

URL：https://osu.ppy.sh/web/check-updates.php?action=check&stream=stable40

参数：stream可以切换为fallback、cutting edge（请自行抓包获取）。

返回内容：一个完整的、可直接运行的、不带本地化数据的osu! 客户端的每个文件的信息和下载地址。

**如果你有一台流量充足、位于国外的服务器，可以使用此API定时爬取客户端，进而搭建客户端镜像。**

```json
[
    {
        "file_version":"1349",
        "filename":"avcodec-51.dll",
        "file_hash":"734e450dd85c16d62c1844f10c6203c0",
        "filesize":"4416072",
        "timestamp":"2015-04-07 05:42:04",
        "patch_id":null,
        "url_full":"http://m1.ppy.sh/r/avcodec-51.dll/f_734e450dd85c16d62c1844f10c6203c0"
    },
    {
        "file_version":"1350",
        "filename":"avformat-52.dll",
        "file_hash":"9c492c0792c4302b4ffaf5f27e48c443",
        "filesize":"717896",
        "timestamp":"2015-04-07 05:45:29",
        "patch_id":null,
        "url_full":"http://m2.ppy.sh/r/avformat-52.dll/f_9c492c0792c4302b4ffaf5f27e48c443"
    },
    {
        "file_version":"1351",
        "filename":"avutil-49.dll",
        "file_hash":"8462c4461db36bc03392ee9576e3d34e",
        "filesize":"68680",
        "timestamp":"2015-04-07 05:46:37",
        "patch_id":null,
        "url_full":"http://m3.ppy.sh/r/avutil-49.dll/f_8462c4461db36bc03392ee9576e3d34e"
    },
    {
        "file_version":"4",
        "filename":"bass.dll",
        "file_hash":"d7f05d3fa5e745e02e1de41821ccccaf",
        "filesize":"98872",
        "timestamp":"2014-08-18 08:17:03",
        "patch_id":"1352",
        "url_full":"http://m3.ppy.sh/r/bass.dll/f_d7f05d3fa5e745e02e1de41821ccccaf",
        "url_patch":"http://m3.ppy.sh/r/bass.dll/p_d7f05d3fa5e745e02e1de41821ccccaf_5ac9068249ad443dfa7b0211330681a5"
    },
    {
        "file_version":"1353",
        "filename":"bass_fx.dll",
        "file_hash":"ede8b6bfd91068ee477e1b6cd438cd0c",
        "filesize":"36000",
        "timestamp":"2015-04-07 05:46:56",
        "patch_id":"2207",
        "url_full":"http://m3.ppy.sh/r/bass_fx.dll/f_ede8b6bfd91068ee477e1b6cd438cd0c",
        "url_patch":"http://m3.ppy.sh/r/bass_fx.dll/p_ede8b6bfd91068ee477e1b6cd438cd0c_3975f6195c3e01c78c97dfc27d75ff06"
    },
    {
        "file_version":"1354",
        "filename":"Microsoft.Ink.dll",
        "file_hash":"340a75fd6e365fc85cfbd04ae295fa28",
        "filesize":"522312",
        "timestamp":"2015-04-07 05:47:22",
        "patch_id":null,
        "url_full":"http://m3.ppy.sh/r/Microsoft.Ink.dll/f_340a75fd6e365fc85cfbd04ae295fa28"
    },
    {
        "file_version":"3108",
        "filename":"osu!.exe",
        "file_hash":"16cf7d54234e4d155310a5b4732a130c",
        "filesize":"4188864",
        "timestamp":"2019-04-10 12:12:14",
        "patch_id":null,
        "url_full":"http://m3.ppy.sh/r/osu!.exe/f_16cf7d54234e4d155310a5b4732a130c"
    },
    {
        "file_version":"3101",
        "filename":"osu!ui.dll",
        "file_hash":"92f3d4a63961c1af25761c9ba63d7fbc",
        "filesize":"36204736",
        "timestamp":"2019-04-01 02:09:20",
        "patch_id":null,
        "url_full":"http://m2.ppy.sh/r/osu!ui.dll/f_92f3d4a63961c1af25761c9ba63d7fbc"
    },
    {
        "file_version":"1347",
        "filename":"pthreadGC2.dll",
        "file_hash":"1d5ab200f8d19cd9e65eb06ccdf6d59a",
        "filesize":"66496",
        "timestamp":"2015-04-07 05:38:06",
        "patch_id":null,
        "url_full":"http://m3.ppy.sh/r/pthreadGC2.dll/f_1d5ab200f8d19cd9e65eb06ccdf6d59a"
    },
    {
        "file_version":"2487",
        "filename":"osu!gameplay.dll",
        "file_hash":"8e04440f100b4389f99b94689b6c3727",
        "filesize":"31843896",
        "timestamp":"2016-04-03 10:19:00",
        "patch_id":null,
        "url_full":"http://m2.ppy.sh/r/osu!gameplay.dll/f_8e04440f100b4389f99b94689b6c3727"
    },
    {
        "file_version":"2428",
        "filename":"OpenTK.dll",
        "file_hash":"87d7774466c2efa2cb801e5fb2ce7b52",
        "filesize":"4306112",
        "timestamp":"2016-02-17 11:30:37",
        "patch_id":null,
        "url_full":"http://m1.ppy.sh/r/OpenTK.dll/f_87d7774466c2efa2cb801e5fb2ce7b52"
    },
    {
        "file_version":"1753",
        "filename":"d3dcompiler_47.dll",
        "file_hash":"c5b362bce86bb0ad3149c4540201331d",
        "filesize":"3466856",
        "timestamp":"2015-08-14 08:35:25",
        "patch_id":null,
        "url_full":"http://m2.ppy.sh/r/d3dcompiler_47.dll/f_c5b362bce86bb0ad3149c4540201331d"
    },
    {
        "file_version":"2426",
        "filename":"libEGL.dll",
        "file_hash":"1b3a1cf8aed3f567a1b4ac6b6696cd05",
        "filesize":"138432",
        "timestamp":"2016-02-17 11:29:50",
        "patch_id":null,
        "url_full":"http://m3.ppy.sh/r/libEGL.dll/f_1b3a1cf8aed3f567a1b4ac6b6696cd05"
    },
    {
        "file_version":"2427",
        "filename":"libGLESv2.dll",
        "file_hash":"6d52dba415b86bb99268b0156b835451",
        "filesize":"3356352",
        "timestamp":"2016-02-17 11:30:11",
        "patch_id":null,
        "url_full":"http://m3.ppy.sh/r/libGLESv2.dll/f_6d52dba415b86bb99268b0156b835451"
    },
    {
        "file_version":"2993",
        "filename":"osu!spooky.dll",
        "file_hash":"efb604a2b5f4b69c1f8d3f29645cba2b",
        "filesize":"18375360",
        "timestamp":"2018-10-23 15:21:13",
        "patch_id":null,
        "url_full":"http://m3.ppy.sh/r/osu!spooky.dll/f_efb604a2b5f4b69c1f8d3f29645cba2b"
    },
    {
        "file_version":"3042",
        "filename":"osu!seasonal.dll",
        "file_hash":"bd12579112f0e44a3c4bc6a2b4aee1c7",
        "filesize":"16965312",
        "timestamp":"2018-12-12 07:30:36",
        "patch_id":null,
        "url_full":"http://m1.ppy.sh/r/osu!seasonal.dll/f_bd12579112f0e44a3c4bc6a2b4aee1c7"
    },
    {
        "file_version":"2870",
        "filename":"discord-rpc.dll",
        "file_hash":"250e4d35ed51ac293527865ca2080c2b",
        "filesize":"304728",
        "timestamp":"2017-12-03 03:38:22",
        "patch_id":null,
        "url_full":"http://m1.ppy.sh/r/discord-rpc.dll/f_250e4d35ed51ac293527865ca2080c2b"
    }
]