Get Player Uuid Inventory Level

GET 
/inventory/v2/player/:player_uuid/inventory-level

Get the levels for items in a player's inventory

Required Permissions:

• For any player (including themselves) any of: inv:*, inv:read_inv:any

• For the player themselves : inv:read_inv:self

Request

Path Parameters

player_uuid uuidrequired

Query Parameters

item_ids integer[]

Responses

200

Successful Response

application/json

Schema

Schema

levels

object[]

Inventory Levels for a Player.

Array [

item_uuid uuidrequired

Item UUID for this Inventory Level.

item_id

object

Item ID for this Inventory Level.

anyOf

MOD1

integer

level Level (integer)required

Current Level

count Count (integer)required

Current quantity

count_for_next_level Count For Next Level (integer)required

Quantity required for the next level.

]

Example (from schema)

{
  "levels": [
    {
      "item_uuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "item_id": 0,
      "level": 0,
      "count": 0,
      "count_for_next_level": 0
    }
  ]
}

403

Error Codes:

• auth_invalid_key_id - Invalid Authorization - Invalid Key ID in Access Token

• auth_invalid_version - Invalid Authorization - version

• auth_malformed_access - Invalid Authorization - malformed access token

• auth_not_jwt - Invalid Authorization

• auth_token_expired - Token is expired

• auth_token_format - Invalid Authorization - {}

• auth_token_invalid_claim - Token contained invalid claim value: {}

• auth_token_invalid_type - Invalid Authorization - Invalid Token Type

• auth_token_sig_invalid - Token Signature is invalid

• auth_token_unknown - Failed to parse token

• insufficient_permissions - Insufficient Permissions

application/json

Schema

Schema

auth_success Auth Success (boolean)

Default value: true

error_code Error Code (string)required
desc Desc (string)required

Example (from schema)

{
  "auth_success": true,
  "error_code": "string",
  "desc": "string"
}

404

The specified player was not found

application/json

Schema

Schema

auth_success Auth Success (boolean)

Default value: true

error_code Error Code (string)required
desc Desc (string)required

Example (from schema)

{
  "auth_success": true,
  "error_code": "string",
  "desc": "string"
}

422

Validation Error

application/json

Schema

Schema

detail

object[]

Array [

loc

object[]

required

Array [

anyOf

MOD1

string

MOD2

integer

]

msg Message (string)required

type Error Type (string)required

]

Example (from schema)

{
  "detail": [
    {
      "loc": [
        "string",
        0
      ],
      "msg": "string",
      "type": "string"
    }
  ]
}

503

Service was unable to fulfill the request at this time and should be retried after the Retry-After wait time

Response Headers

• Retry-After

  integer

  Number of seconds after which to retry the request, when the server should have the resource available

application/json

Schema

Schema

auth_success Auth Success (boolean)

Default value: true

error_code Error Code (string)required
desc Desc (string)required

Example (from schema)

{
  "auth_success": true,
  "error_code": "string",
  "desc": "string"
}

Loading...