API v2 knowledge

API base

https://osu.ppy.sh/api/v2

Access API v2 with oauth token

Add following line to your header:

Authorization: {$token_type} {$token}

Usually, $token_type is Bearer

Refresh an expired token

Request

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=**********************

Response

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