An unofficial game tracking and ranking ROOT Digital League

API Root Digital League

URL

  • Match API.
    • List view.
    • Lookup with match id : https://rootleague.pliskin.dev/api/match/<id>/
  • Player API.
    • List view.
    • Lookup with player id : https://rootleague.pliskin.dev/api/player/<id>/
  • Player registration API.
    • List view.
    • Lookup with discord username: https://rootleague.pliskin.dev/api/registration/<discord_username>/

Notes

  • In-progress games are filtered out.
  • Results in the list view are paginated to avoid performance issues. You can change the default page size of 50 by using the query parameter ?limit=
  • Participants are nested in the Match API. There is no direct API to participants. If there is a demand for it, use the #rdl-stats-and-analysis discord channel to contact us.
  • The nested participants refer to a player id that can be used to lookup the Player API.
  • The Registration API is identical to the Player API but can be used with a discord username lookup, to check if a player is registered.
  • The API has a daily throttling rate to avoid abuse. Authenticated users have a higher rate than anonymous calls. If you plan a high number of calls per day, consider logging in with your account.
    • Basic authentication is possible, e.g. curl -u "username:password" -X GET <URL>, but might be removed in the future.
    • Token authentication is recommended, with header Authorization: Token <token> (a space is needed betwen Token and its value).
      • E.g. curl -H "Authorization: Token <token>" -X GET <URL>
      • To obtain a token, you can generate one in your profile page.

Filters

  • The Match API has built-in filters with query parameters. See the web interface for the full list of filters.
  • Examples:
    • ?tournament__name=M04
    • ?board_map=autumn&deck=e%26p&tournament__name=M03
    • ?participants__faction=cats