Reclamar mision

Reclamar la recompensa de una mision completada.

POST/api/sdk/missions/claim

Reclama la recompensa de una mision completada. Solo necesario si autoClaimReward es false.

Request body

ParametroTipoDescripcion

Se requiere clientId o externalUserId.

Ejemplo

curl -X POST https://southgames.ai/api/sdk/missions/claim \
  -H "Authorization: Bearer sg_live_xxx" \
  -H "X-Org-Id: mi-empresa" \
  -H "Content-Type: application/json" \
  -d '{
    "missionId": "mission_abc",
    "externalUserId": "user_123"
  }'

Respuesta

{
  "success": true,
  "data": {
    "success": true,
    "missionId": "mission_abc",
    "rewards": [
      { "type": "points", "amount": 100 },
      { "type": "xp", "amount": 50 }
    ]
  }
}

Errores

CodigoHTTPDescripcion
BAD_REQUEST400Mision no encontrada o no esta completada

Notas

  • Si la mision tiene autoClaimReward: true, las recompensas se otorgan automaticamente al completar todos los objetivos.
  • Este endpoint solo es necesario para misiones con autoClaimReward: false.
  • Las recompensas posibles son: xp, points, promo_code y webhook.