Changelog
Important changes will be listed here
Last updated
Was this helpful?
Important changes will be listed here
Last updated
Was this helpful?
Daily Objectives endpoint.
BedWars API endpoint.
Swagger-UI found at
The API's endpoint now is . This will allow me to push new versions but let the old version stay online when significant changes to the existing nodes are made without everyone immediately having to update their programs.
The old endpoint will continue working for some time but will most likely be dropped once the full release of the API comes out. I highly suggest you to switch to /api/v1/ as soon as possible.
Changed the way authentication is made. You should/can no longer provide your token in the URL as a parameter but should switch to using the header for providing your token.
If you are using Java's HttpsURLConnection for example, this would look like the following:
connection.addRequestProperty("Authorization", "Bearer {token}");
For all the endpoints that existed before this update, the old authentication will still work until at the latest when the full release of the API comes out.
Getting the summed stats of all seasons of a player is no longer done by providing season="-1" or season="all" but is now done by simply calling /stats/{player}/all. This request no longer costs a fixed 2 requests but now costs min(1, season - 1) requests.
The TopStats is no longer a Map<Integer, Stats> but is now a List<Stats> for all modes that have top stats.
The endpoint /fastbuilder/stats/{player} now also returns both the player info and the global stats of the player instead of only the global stats.
Added User- and RateLimit information to the Response-Header.
If a player has not played a specific mode yet but the player exists the response code will still be 204 but the "data" will now return the "playerInfo" object. Just the "stats" object will be "null".
If a request returns "null" as data (e.g. the player has been on the server but has never played that specific game you are requesting their stats) then the status of the request will be "204 - No Content" in order to avoid NullPointerException's in your code by simply asking if the status is 204.
Minesweeper "Global stats (and of season)" will no longer return the season in the body because you have to specify the season as path variable if you want to get a specific season and therefore the information is unnecessary.
I was able to restore the "mines" defused in season 1.
Minesweeper statistics
You can now request players information.
If there are two or more players with the same name in the Database (yes, that can happen and is totally fine) the API will fetch the new names of all players and return the correct one (if there still is a player with that name after the cleanup).
The Top-Player updater would still use the main MySQL connection resulting in a regular lag of 0.5s every 10 seconds.
Global mode stats will now also feature a distribution map of best times and amount of players with that best time. Note that all players with best times below maxConfirmedTime won't show up in this distribution unless they get confirmed.
All global stats as mode stats and top stats are now cached and will only update every 10 seconds but therefore they will only cost one rate request.
Top-Board for Short would show up but this should not happen because we don't officially confirm times in Short.
processTime to the response
FastBuilder modes list, global mode stats, global stats, global player stats
Path to FastBuilder API from /stats/fastbuilder to solely fastbuilder
FastBuilder top pages
FastBuilder player stats
Token authentication ?token={token}
Main page