Headers:
-
Authorization: nadeo_v1 t={token}An access token for theNadeoLiveServicesaudience
Service provided by Openplanet
Get club campaign by ID
GET
https://live-services.trackmania.nadeo.live/api/token/club/{clubID}/campaign/{campaignId}
Headers:
Authorization: nadeo_v1 t={token}
An access token for the NadeoLiveServices audience
Path parameters:
{clubID}
integer
The ID of the club the campaign belongs to
*
{campaignId}
integer
The campaign ID of the campaign to be requested
*
Gets the details of a specific club campaign.
Remarks:
.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.Example request:
GET https://live-services.trackmania.nadeo.live/api/token/club/19489/campaign/28446
Example response:
{
"clubDecalUrl": "",
"campaignId": 28446,
"activityId": 302134,
"campaign": {
"id": 28446,
"seasonUid": "NLS-oCLUEcsEL1c45ePnhFnW4wZv4vkd1VKijYY",
"name": "Icy Summer 2022",
"color": "",
"useCase": 2,
"clubId": 19489,
"leaderboardGroupUid": "NLS-oCLUEcsEL1c45ePnhFnW4wZv4vkd1VKijYY",
"publicationTimestamp": 1658480776,
"startTimestamp": 1658480776,
"endTimestamp": 0,
"rankingSentTimestamp": null,
"year": -1,
"week": -1,
"day": -1,
"monthYear": -1,
"month": -1,
"monthDay": -1,
"published": true,
"playlist": [
{
"id": 314741,
"position": 0,
"mapUid": "tknxMmzHqPOImrE7FWNzzdvCia2"
},
...
{
"id": 314857,
"position": 24,
"mapUid": "i5dupTLKB6AquA1yhsNp40SjXF2"
}
],
"latestSeasons": [
{
"uid": "NLS-oCLUEcsEL1c45ePnhFnW4wZv4vkd1VKijYY",
"name": "Icy Summer 2022",
"startTimestamp": 1658480776,
"endTimestamp": 0,
"relativeStart": -47124886,
"relativeEnd": 0,
"campaignId": 28446,
"active": true
}
],
"categories": [
{
"position": 0,
"length": 5,
"name": "Icy Summer 2022"
}
],
"media": {
"buttonBackgroundUrl": "",
"buttonForegroundUrl": "",
"decalUrl": "",
"popUpBackgroundUrl": "",
"popUpImageUrl": "",
"liveButtonBackgroundUrl": "",
"liveButtonForegroundUrl": ""
},
"editionTimestamp": 1658531133
},
"popularityLevel": 0,
"publicationTimestamp": 1658480776,
"creationTimestamp": 1658480776,
"creatorAccountId": "1e64ec02-5384-431b-9a34-c180e2e072f7",
"latestEditorAccountId": "1e64ec02-5384-431b-9a34-c180e2e072f7",
"id": 302134,
"clubId": 19489,
"clubName": "$s$900Flink's $fffclub",
"name": "Icy Summer 2022",
"mapsCount": 25,
"mediaUrl": "https://trackmania-prod-media-s3.cdn.ubi.com/media/image/live-api/809d31a8-102d-4e27-9152-adece083e2d1/dds/game.dds?timestamp=1705423431.dds",
"mediaUrlPngLarge": "https://trackmania-prod-media-s3.cdn.ubi.com/media/image/live-api/809d31a8-102d-4e27-9152-adece083e2d1/png/large.png?timestamp=1705423431.png",
"mediaUrlPngMedium": "https://trackmania-prod-media-s3.cdn.ubi.com/media/image/live-api/809d31a8-102d-4e27-9152-adece083e2d1/png/medium.png?timestamp=1705423431.png",
"mediaUrlPngSmall": "https://trackmania-prod-media-s3.cdn.ubi.com/media/image/live-api/809d31a8-102d-4e27-9152-adece083e2d1/png/small.png?timestamp=1705423431.png",
"mediaUrlDds": "https://trackmania-prod-media-s3.cdn.ubi.com/media/image/live-api/809d31a8-102d-4e27-9152-adece083e2d1/dds/game.dds?timestamp=1705423431.dds",
"mediaTheme": ""
}
If the club or campaign does not exist, the response will contain an error (status 404):
["activity:error-notFound"]
If the campaign 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 be empty for unknown reasons (status 200):
This is consistent for a given campaign; and campaigns with this issue still appear as normal in get club activities.