Sonolus Wiki

GET /sonolus/{type}/{itemName}/leaderboards/{leaderboardName}

/sonolus/{type}/{itemName}/leaderboards/{leaderboardName} provides detailed information of leaderboard of name {leaderboardName} in item of name {itemName}, and is used by Sonolus app to populate server item details view's leaderboard section.

URL Parameters

URL ParameterValueDescription
typestringposts, playlists, levels, skins, backgrounds, effects, particles, engines, or replays.
itemNamestringName of item.
leaderboardNamestringName of leaderboard.

Query Parameters

Query ParameterValueDescription
localizationstringSee localization.
Configuration OptionsanySee Options Query Parameters.

Request Headers

HeaderValueDescription
Sonolus-SessionstringOptional, see Sonolus-Session.

Request Body

None.

Response Code

CodeDescription
200 OK
401 UnauthorizedAuthentication required or expired.
404 Not Found

Response Headers

HeaderValueDescription
Sonolus-VersionstringOptional, see Sonolus-Version.

Response Body

type ServerItemLeaderboardDetails = {
    topRecords: ServerItemLeaderboardRecord[]
}

Examples

{
    "topRecords": [
        // ...
    ]
}