Query parameters:
-
{mapUid}
(string) The UID of the map *Maximum:50 map UIDs
-
{score}
(integer) The score/time to get the position for *
Service provided by Openplanet
Get record positions by their time
Audience: NadeoLiveServices
POST
https://live-services.trackmania.nadeo.live/api/token/leaderboard/group/map?scores[{mapUid}]={score}
Query parameters:
{mapUid}
(string)
The UID of the map
*
50 map UIDs
{score}
(integer)
The score/time to get the position for
*
Body parameters:
{groupUid}
(string)
The ID of the group/season for a specific map
*
The request body is an array of maps, identified by their mapUids:
{
"maps": [
{
"mapUid": "{mapUid}",
"groupUid": "{groupUid}"
}
]
}
Gets position data for one or more records by their score/time.
Remarks:
groupUid
"Personal_Best"
can be used to get the global leaderboard.groupUid
, make sure you're only referencing currently open leaderboards. Maps with closed leaderboards will not be included in the response.mapUid
parameter in the URL has to correspond with a map in the request body.Example request:
POST https://live-services.trackmania.nadeo.live/api/token/leaderboard/group/map?scores[gjt2DWATrQ_NdrbrXG0G9oDpTfh]=15800&scores[XiGZvMOqIgT3_g0TdeFa0lxMp46]=17500
{
"maps": [
{
"mapUid": "gjt2DWATrQ_NdrbrXG0G9oDpTfh",
"groupUid": "Personal_Best"
},
{
"mapUid": "XiGZvMOqIgT3_g0TdeFa0lxMp46",
"groupUid": "Personal_Best"
}
]
}
Example response:
[
{
"groupUid": "Personal_Best",
"mapUid": "gjt2DWATrQ_NdrbrXG0G9oDpTfh",
"score": 15800,
"zones": [
{
"zoneId": "301e1b69-7e13-11e8-8060-e284abfd2bc4",
"zoneName": "World",
"ranking": {
"position": 294,
"length": 0
}
}
]
},
{
"groupUid": "Personal_Best",
"mapUid": "XiGZvMOqIgT3_g0TdeFa0lxMp46",
"score": 17500,
"zones": [
{
"zoneId": "301e1b69-7e13-11e8-8060-e284abfd2bc4",
"zoneName": "World",
"ranking": {
"position": 42,
"length": 0
}
}
]
}
]
If a groupUid
or a mapUid
is invalid (or the referenced leaderboard is closed), the response will simply omit that map's record.
If the query parameters reference a map that is not contained in the request body, the endpoint may return a 500
error.