Tier del cliente

Obtener el tier y XP actual de un cliente.

GET/api/v1/clients/tier

Retorna el tier actual, XP y progreso hacia el siguiente tier.

Query params

Parametro	Tipo	Descripcion

Ejemplo

curl "https://southgames.ai/api/v1/clients/tier?externalUserId=user_123" \
  -H "Authorization: Bearer sg_live_xxx" \
  -H "X-Org-Id: mi-empresa"

Respuesta

{
  "clientId": "user_123",
  "xp": 450,
  "tier": {
    "id": "bronze",
    "name": "Bronce",
    "color": "#cd7f32",
    "icon": "medal",
    "benefits": ["5% de descuento"]
  },
  "nextTier": {
    "name": "Plata",
    "minXp": 600,
    "xpRemaining": 150
  },
  "stats": {
    "totalGamesPlayed": 12,
    "totalWins": 7,
    "totalCodesRedeemed": 3
  }
}

Campo	Tipo	Descripcion
`tier`	`number`	Tier actual
`tierName`	`string`	Nombre del tier
`xp`	`number`	XP total acumulado
`xpForCurrentTier`	`number`	XP requerido para el tier actual
`xpForNextTier`	`number`	XP requerido para el siguiente tier
`progress`	`number`	Progreso (0-1) hacia el siguiente tier