Jugar

Ejecutar una jugada en una campana.

POST/api/v1/games/play

Ejecuta una jugada. Genera codigo promo si gana. Otorga XP y puntos automaticamente.

Request body

Parametro	Tipo	Descripcion

Ejemplo

curl -X POST https://southgames.ai/api/v1/games/play \
  -H "Authorization: Bearer sg_live_xxx" \
  -H "X-Org-Id: mi-empresa" \
  -H "Content-Type: application/json" \
  -d '{
    "campaignId": "campaign_abc",
    "externalUserId": "user_123"
  }'

Respuesta

{
  "sessionId": "session_xyz",
  "result": "Premio: 20% de descuento",
  "won": true,
  "prizeCode": "SG-AB2C-XY9Z",
  "metadata": {
    "segment": "Premio: 20% de descuento",
    "prizeType": "discount",
    "discountType": "percentage",
    "discountValue": 20
  },
  "xpAwarded": 50,
  "newTotalXp": 320,
  "tierUp": {
    "previousTier": "Bronce",
    "newTier": "Plata",
    "newTierColor": "#C0C0C0"
  },
  "pointsAwarded": 10,
  "newPointsBalance": 150,
  "limits": {
    "playsRemaining": 2,
    "playLimitPeriod": "day",
    "winsRemaining": 1,
    "rewardLimitPeriod": "day"
  }
}

Webhooks

Se disparan los siguientes eventos:

game.played — en cada jugada
game.won — cuando el usuario gana