Authenticating The Request
This end point is for secret key authenticated requests only. Signed in players cannot call this end point.
- secret string Required
- Your games secret API key.
Request Parameters
- gameID guid Required
- The ID of the game you are making this request against. You can find the ID of your game in your Construct Game Services (CGS) account.
- leaderboardID guid Required
- The ID of the leaderboard you're deleting scores on.
- scoreID guid Sometimes required
- The ID of the score you're deleting. You must specify this or
playerID.
- playerID guid Sometimes required
- The ID of the player to delete scores for. Will delete up to
10000 of this players scores on each call, with the mightHaveMore response parameter indicating if they have more scores. Scores are deleted in no particular order. You must specify this or scoreID.
Success Response
Successful responses always return a HTTP 200 status code.
{
"success": true,
"mightHaveMore": false,
"scoresDeleted": 21,
"formattingCulture": "en-us",
"responseLanguage": {
"iso": "EN",
"englishName": "English"
}
}
Response Properties
- success bool
- If the request was successfull or not.
- mightHaveMore bool
- If the scores deleted is the maximum allowed to be deleted in one request, this value will show as true indicating that there may be more scores to delete in this request.
- scoresDeleted int32
- The number of scores deleted. This can range from 0 to 10000. No more than 10000 scores can be deleted in any one request.
- formattingCulture string
- If some return values are culture specific, this property indicates what culture the values have been rendered as.
- responseLanguage Language
- The language of translatable elements in the response. If this is different to the requested language, then it is likely your plan has run out of translation credits.
Failure Response
Unsuccessful responses always return HTTP 4xx status codes.
{
"success": false,
"errorMessage": "Your request failed due to...",
"helpURL": "https://www.construct.net/en/game-services/manuals/game-services/leaderboards/api-end-points/scores/delete-scores",
"shouldRetry": false
}
Response Properties
- success bool
- If the request was successfull or not.
- errorMessage string
- An error message with more detailed information on why the request failed.
- helpURL url (string)
- A link to documentation which should provide help with the error.
- shouldRetry bool
- Should the client wait a short period of time and retry the request. Usually this is false, but returns true if the request failed due to rate limiting.