Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

GET /players/{uuid} #1

Open
acrylic-style opened this issue Jul 10, 2022 · 0 comments
Open

GET /players/{uuid} #1

acrylic-style opened this issue Jul 10, 2022 · 0 comments
Labels
enhancement New feature or request

Comments

@acrylic-style
Copy link
Member

acrylic-style commented Jul 10, 2022

GET /players/1865ab8c-700b-478b-9b52-a8c58739df1a

would return 200 OK:

{
  "uuid": "1865ab8c-700b-478b-9b52-a8c58739df1a",
  "name": "KotlinLove", // username stored in database, not mojang
  "groups": [
    // sorted by weight (first element is their highest group)
    // some non-public groups (such as switchdeveloper and punishment related groups) may be excluded from this list
    // Sara (such as 100yen) is also included in this list, but groups of lower prices may or may not be missing. Highest sara is always included.
    "developer"
  ],
  "servers": {
    "life": {
      "admin": false,
      "moderator": false, // moderator and builder can be true at same time
      "builder": false,
      "rank": 7, // number of > 0
      // these balance values might be negative in rare cases
      "balance": 16256025.26, // result is equal to raw_balance + raw_offline_balance
      "raw_balance": 16256025.26,
      "raw_offline_balance": 0.0, // the balance which is still yet to be applied
      "total_play_time": 91219 // in minutes, same as tsl.total_play_time
    },
    "tsl": {
      "admin": false,
      "moderator": false,
      "builder": false,
      "total_play_time": 91219 // in minutes, same as life.total_play_time
    },
    "lgw": {
      "admin": false,
      "moderator": false,
      "builder": false,
      "vip": false
    },
    "despawn": {
      "admin": false,
      "moderator": false,
      "builder": false
    },
    "diverse": {
      "admin": false,
      "moderator": false,
      "builder": false
      // exp, money, veteranpoint, title might be added in the future
    },
    "vanilife": {
      "admin": false,
      "moderator": false,
      "builder": false
    }
  }
}

GET /players/bbd2e5c9-a232-3cc3-96b3-eba47c24f841

would return 400 Bad Request:

{
  "error": "cannot get player from offline (version 3) UUID"
}

Note: version 0 (used for accounts of Bedrock Edition) UUIDs should be allowed.

@acrylic-style acrylic-style added the enhancement New feature or request label Jul 10, 2022
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
enhancement New feature or request
Projects
None yet
Development

No branches or pull requests

1 participant