Get Player Linked Portals

GET 
/users/v1/player/:player_id/linked_portals

deprecated

DEPRECATED Please use /v2/player/{player_uuid}/links instead. Get a player's linked portals.

Request

Path Parameters

player_id Player Idrequired

Responses

200

Successful Response

application/json

Schema

Schema

player

object

required

Response for getting a player's info

player_id Player Id (integer)requireddeprecated

Player ID DEPRECATED use player_uuid instead

player_uuid uuidrequired

Player UUID

active_player_id Active Player Id (integer)deprecated

DEPRECATED use active_player_uuid instead. Active player ID, if the player has an active player.

active_player_uuid uuid

Active player UUID, if the player has an active player.

person_id uuidrequired

Person ID

role_id Role Id (string)

Role ID of the person, if available

linked_portals

object[]

required

List of linked portals

Array [

portal_user_id Portal User Id (string)

Portal user ID

portal_id Portal Id (integer)requireddeprecated

Portal ID DEPRECATED use platform instead

platform Platform (string)required

Possible values: [Anon, Basic, XboxLive, PSN, NintendoNAID, NintendoSwitch, NintendoPPID, Google, GooglePlay, Apple, Epic, Steam, Amazon, Twitch, RallyHere, LegacyName]

An enumeration.

display_name Display Name (string)

Display name

player_id Player Id (integer)requireddeprecated

Player ID DEPRECATED use player_uuid instead

player_uuid uuidrequired

Player UUID

]

Example (from schema)

{
  "player": {
    "player_uuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "active_player_uuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "person_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "role_id": "string"
  },
  "linked_portals": [
    {
      "portal_user_id": "string",
      "platform": "Anon",
      "display_name": "string",
      "player_uuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6"
    }
  ]
}

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

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"
    }
  ]
}

Loading...