Players

Un jugador de tu juego ya tiene una cuenta en otro lado — en Roblox, en Steam, en tu propia plataforma. Estas rutas vinculan esa identidad con un registro del workspace, para que el resto del workspace pueda direccionar al jugador sin que tu juego invente un segundo sistema de cuentas.

Auth: API key, sk_live_ o pk_live_.

Identificar a un jugador

POST /{workspaceId}/players/identify

{
  "platform": "roblox",
  "platformPlayerId": "1234567",
  "displayName": "ada",
  "metadata": { "accountAge": 812, "region": "us-east" }
}

Crea el vínculo de identidad, o actualiza el que ya existe — llámalo en cada inicio de sesión y deja que se acomode. platform se pasa a minúsculas por ti; los valores reconocidos son roblox, minecraft, steam, fivem, unity, unreal y custom.

displayName y metadata se guardan para rankings y vistas de administración. Ninguno se confía para nada que importe.

Lee platformPlayerId en tu servidor, desde la API de la plataforma. Un valor que te mandó el cliente del juego es un valor que el jugador puede cambiar.

Resolver uno

GET /{workspaceId}/players/resolve/{platform}/{platformPlayerId}

{
  "id": "…",
  "platform": "roblox",
  "platformPlayerId": "1234567",
  "contactId": "…",
  "displayName": "ada",
  "firstSeenAt": "2026-01-02T18:04:00Z",
  "lastSeenAt": "2026-01-14T09:22:11Z",
  "isValidated": true
}

404 con PLAYER_NOT_FOUND cuando no hay vínculo.

Listarlos

GET /{workspaceId}/players?platform=roblox&page=1&pageSize=50

Los tres parámetros son opcionales; platform acota, y la paginación arranca en página 1 de 50. Esto es para paneles y pantallas de administración, no para el loop de un juego.

Errores

Planos, pero con un code al lado del mensaje — una forma que sólo tienen estas rutas:

{ "code": "PLAYER_NOT_FOUND", "message": "No identity link for roblox:1234567" }

Darle sesión al jugador

Identificar a un jugador no es lo mismo que darle una sesión. Para eso —un JWT que el cliente del jugador pueda llevar a /query, con roles detrás— mira POST /{workspaceId}/auth/{providerSlug}/assert en Autenticación de usuarios finales.