BlueDragon Public API Reference

Posted by: FluxCreated: Feb 18, 2023Last Modified: Feb 26, 2023

Usage

Base URL

https://bluedragonmc.com/api/

Requests

All requests should be GET requests. Any other request methods may not be supported.

Authentication

The API currently does not rely on any authentication. If we see an unsustainable number of requests, we may add an API key system for rate limiting.

Player Information

Path: /player

Sample URL:

https://bluedragonmc.com/api/player?username=wsad_

Query Parameters

Sample Response

{
  "username": "wsad_",
  "uuid": "110429e8-197f-4446-8bec-5d66f17be4d5",
  "stats": {
    "game_infinijump_highest_score": 227,
    "game_wackymaze_wins": 82,
    "game_skywars_wins": 4,
    "lobby_parkour_cave_best_time": 20635,
    ...
  },
  "lastLogin": 1676755435986,
  "xp": 22183,
  "cosmeticCount": 39,
  "level": 18.24107289740401,
  "coins": 22133,
  "meta": {
    "prefix": "<dark_gray>[<#B72A2A>Owner<dark_gray>] ",
    "primaryGroup": "owner",
    "rankcolor": "#B72A2A"
  }
}

Notes

• firstLogin may not be present on some users.
• firstLogin and lastLogin are measured as Unix timestamps.
• A player’s level is directly based on their xp. See the formula here.
• The meta.prefix and meta.rankcolor may not be present on users without a rank.
• If a player has not logged in to BlueDragon yet, the API will return a 404 error with the text "Not found".

Leaderboard Information

Path: /leaderboard

Sample URL:

https://bluedragonmc.com/api/leaderboard?statistic=game_wackymaze_wins&sort=-1

Query Parameters

Sample Response

{
  "statistic": "game_wackymaze_wins",
  "sort": -1,
  "leaderboard": [
    {
      "uuid": "a0048143-460f-417e-9119-f30eb9674a7a",
      "username": "ex4",
      "value": 116
    },
    {
      "uuid": "110429e8-197f-4446-8bec-5d66f17be4d5",
      "username": "wsad_",
      "value": 82
    },
    ...
  ]
}

Notes

• The leaderboard list contains a set of entries, each containing a uuid, username, and value.
• Any leaderboards involving time (namely Fastest Time) will be measured in milliseconds.
• Only the first 50 entries (if present) will be included in the response.

Leaderboard Position Information

Path: /leaderboard/position

Sample URL:

https://bluedragonmc.com/api/leaderboard/position?username=wsad_&statistic=game_wackymaze_wins

Query Parameters

Sample Response

{
  "uuid": "110429e8-197f-4446-8bec-5d66f17be4d5",
  "username": "wsad_",
  "statistic": "game_wackymaze_wins",
  "position": 2
}

Notes

• The returned statistic will always be the same as the one specified in the URL parameter.
• If the player has the requested statistic, the position field has a minimum of 1 (the first position according to the sort).
  • If the player does not have the requested statistic, a 404 error code will be returned.
  • If the statistic is invalid, a 400 error code will be returned.
• There is no reason to fetch data more frequently than once every 5 minutes as responses are cached.

List of Statistic Names

Have an idea for a statistic we should track? Let us know in our Discord server.