Headers:
-
Authorization: nadeo_v1 t={token}An access token for theNadeoLiveServicesaudience
Service provided by Openplanet
Get club room by ID
GET
https://live-services.trackmania.nadeo.live/api/token/club/{clubID}/room/{activityId}
Headers:
Authorization: nadeo_v1 t={token}
An access token for the NadeoLiveServices audience
Path parameters:
{clubID}
integer
The ID of the club the room belongs to
*
{activityId}
integer
The activity ID of the room to be requested
*
Gets the details of a specific club room.
Remarks:
maps and scriptSettings will likely be empty..dds media files by default, while several scaled .png versions are available using separate fields (see example below for reference). This only applies for custom media files, and not for preset themes.0, instead of an array.Example request:
GET https://live-services.trackmania.nadeo.live/api/token/club/25/room/381929
Example response:
{
"id": 381929,
"clubId": 25,
"clubName": "$s$fffTM $6F9Exchange",
"nadeo": true,
"roomId": 137873,
"campaignId": null,
"playerServerLogin": null,
"activityId": 381929,
"name": "TM Exchange Pack 1",
"room": {
"id": 137873,
"name": "TM Exchange Pack 1",
"region": "eu-west",
"serverAccountId": "",
"maxPlayers": 64,
"playerCount": 0,
"maps": [
"gXTE8jV8fF75hyXuRR8yuuhg6ym",
"7AHlBi2o62SmM3D0lNCieqT6Er6",
"tY8ydiSluqxKMw6bEkAG1V3oUde",
...
"TB7r1bdx3xjIN89JwgKHjMusJJ6",
"jC9YYcCbHpEuyIHDsCjIXuxWHdh",
"Y_HCdBUZJ4vw96dPq1rDFRrKHSk"
],
"script": "TrackMania/TM_TimeAttack_Online.Script.txt",
"scalable": true,
"scriptSettings": {
"S_TimeLimit": {
"key": "S_TimeLimit",
"value": "360",
"type": "integer"
},
"S_DecoImageUrl_WhoAmIUrl": {
"key": "S_DecoImageUrl_WhoAmIUrl",
"value": "/api/club/25",
"type": "text"
},
"S_EnableJoinLeaveNotifications": {
"key": "S_EnableJoinLeaveNotifications",
"value": "false",
"type": "boolean"
},
"S_ForceLapsNb": {
"key": "S_ForceLapsNb",
"value": "-1",
"type": "integer"
}
},
"shufflePlaylist": true,
"serverInfo": null
},
"popularityLevel": 0,
"creationTimestamp": 1683021002,
"creatorAccountId": "a07f01cd-afb0-4230-9c13-868c1ede28a3",
"latestEditorAccountId": "a07f01cd-afb0-4230-9c13-868c1ede28a3",
"password": false,
"mediaUrl": "https://trackmania-prod-media-s3.cdn.ubi.com/media/image/live-api/6e29ffb6-ff4d-4e50-b9dd-e3c519864435/dds/game.dds?timestamp=1705430827.dds",
"mediaUrlPngLarge": "https://trackmania-prod-media-s3.cdn.ubi.com/media/image/live-api/6e29ffb6-ff4d-4e50-b9dd-e3c519864435/png/large.png?timestamp=1705430827.png",
"mediaUrlPngMedium": "https://trackmania-prod-media-s3.cdn.ubi.com/media/image/live-api/6e29ffb6-ff4d-4e50-b9dd-e3c519864435/png/medium.png?timestamp=1705430827.png",
"mediaUrlPngSmall": "https://trackmania-prod-media-s3.cdn.ubi.com/media/image/live-api/6e29ffb6-ff4d-4e50-b9dd-e3c519864435/png/small.png?timestamp=1705430827.png",
"mediaUrlDds": "https://trackmania-prod-media-s3.cdn.ubi.com/media/image/live-api/6e29ffb6-ff4d-4e50-b9dd-e3c519864435/dds/game.dds?timestamp=1705430827.dds",
"mediaTheme": ""
}
If the club or room does not exist, the response will contain an error (status 404):
["activity:error-notFound"]
If the room is private and the player is not a member of the club, the response will contain an error (status 403):
["clubMemberRole:error-notMember"]
In some rare cases the response may contain one of the following errors for unknown reasons (status 404):
This is consistent for a given room; and rooms with this error still appear as normal in get club activities.
["playerServer:error-notFound"]
["room:error-notFound"]