SouthGamesSouthGames/Docs
Iniciar Sesion

Puntos

Economia de puntos: emitidos, gastados, saldo y serie temporal.

Resumen

GET/api/v1/metrics/points/summary

Snapshot en vivo de la economia de puntos: total emitido, gastado, saldo pendiente (pasivo) y cuantos clientes tienen puntos.

curl "https://southgames.ai/api/v1/metrics/points/summary" \
  -H "Authorization: Bearer sg_live_xxx" \
  -H "X-Org-Id: mi-empresa"

{
  "totalEarned": 1250000,
  "totalSpent": 480000,
  "totalBalance": 770000,
  "clientsWithPoints": 2890,
  "totalClients": 3120
}

Serie temporal

GET/api/v1/metrics/points/timeseries

Serie diaria de puntos emitidos vs gastados. Respaldada por el rollup nocturno (puede tener hasta ~24h de retraso).

ParametroTipoDescripcion
{
  "range": { "from": "2026-06-14T00:00:00.000Z", "to": "2026-06-16T00:00:00.000Z" },
  "granularity": "day",
  "freshness": "daily-rollup",
  "totals": { "earned": 42000, "spent": 18000 },
  "series": [
    { "date": "2026-06-14", "earned": 1500, "spent": 600 },
    { "date": "2026-06-15", "earned": 1800, "spent": 720 }
  ]
}