SouthGamesSouthGames/Docs
Iniciar Sesion

Codigos

Codigos promocionales emitidos vs canjeados y tasa de canje.

Resumen de codigos

GET/api/v1/metrics/codes/summary

Codigos emitidos vs canjeados en un rango, con tasa de canje y serie diaria. Respaldado por el rollup nocturno (~24h de retraso).

ParametroTipoDescripcion
curl "https://southgames.ai/api/v1/metrics/codes/summary?from=2026-05-17&to=2026-06-16" \
  -H "Authorization: Bearer sg_live_xxx" \
  -H "X-Org-Id: mi-empresa"

{
  "range": { "from": "2026-05-17T00:00:00.000Z", "to": "2026-06-16T00:00:00.000Z" },
  "granularity": "day",
  "freshness": "daily-rollup",
  "totals": { "issued": 5000, "redeemed": 412, "redemptionRate": 8 },
  "series": [
    { "date": "2026-06-14", "issued": 200, "redeemed": 18 },
    { "date": "2026-06-15", "issued": 150, "redeemed": 25 }
  ]
}

redeemed proviene del log de canjes por evento (codeRedemptions), que se escribe de forma best-effort. issued cuenta los codigos creados ese dia. redemptionRate es redeemed / issued * 100.