Jugar

Ejecutar una jugada en una campana.

POST/api/sdk/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/sdk/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

{
  "success": true,
  "data": {
    "sessionId": "session_xyz",
    "won": true,
    "result": "Premio: 20% de descuento",
    "prizeCode": "SG-AB2C-XY9Z",
    "metadata": { "segment": 3, "prize": "20% off" },
    "xpAwarded": 50,
    "newLevel": 2,
    "levelName": "Plata",
    "pointsAwarded": 10,
    "newPointsBalance": 150
  }
}

Webhooks

Se disparan los siguientes eventos:

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