Skip to main content

Player API

Endpoints


Identify a player

GET https://api.trytalo.com/v1/players/identify

Query keys

KeyRequiredDescription
identifier YesThe unique identifier of the player. This can be their username, an email or a numeric ID
service YesThe name of the service where the identity of the player comes from (e.g. "steam", "epic" or "username")

Sample response

{ ... }

Merge two players

POST https://api.trytalo.com/v1/players/merge

Body keys

KeyRequiredDescription
playerId1 YesThe first player ID - the second player will be merged into this player
playerId2 YesThe second player ID

Sample request

{ ... }

Sample response

{ ... }

Update a player's props

PATCH https://api.trytalo.com/v1/players/:id

Route params

KeyRequiredDescription
id Yes

Body keys

KeyRequiredDescription
props NoAn array of Props. Props that the player doesn't have will be added. Props with updated values will overwrite existing props. Props with a null value will be deleted from the player

Sample request

{ ... }

Sample response

{ ... }

Types

Prop

Prop {
key: string,
value: string | null
}