Player API
Talo provides a powerful and secure authentication system out of the box. You can use Talo to authenticate players using their email, username, or any other identifier you choose.
Players can have any number of arbitrary properties that will persist between game sessions and all of their identities. You can use these, for example, to store a player's current health or level.
Learn more about player management here.
Endpoints
Identify a player
GET https://api.trytalo.com/v1/players/identify
Headers
Key | Required | Description |
---|---|---|
x-talo-session | ❌ No | The session token (required if using Talo player authentication) |
Route params
None available
Query keys
Key | Required | Description |
---|---|---|
identifier | ✅ Yes | The unique identifier of the player. This can be their username, an email or a numeric ID |
service | ✅ Yes | The name of the service where the identity of the player comes from (e.g. "steam", "epic" or "username") |
Sample response
{ ... }
Steam authentication with identity (identifier format is <identity>:<ticket>)
{ ... }
Steam authentication without identity
{ ... }
Find a player
GET https://api.trytalo.com/v1/players/:id
Headers
None available
Route params
Key | Required | Description |
---|---|---|
id | ✅ Yes | The ID of the player |
Query keys
None available
Sample response
{ ... }
Merge two players
POST https://api.trytalo.com/v1/players/merge
Sample request
{ ... }
Sample response
{ ... }
Update a player's props
PATCH https://api.trytalo.com/v1/players/:id
Sample request
{ ... }
Sample response
{ ... }
Types
Prop
type Prop = {
key: string
value: string | null
}