Productos · Loyalty API

Una API REST limpia para lealtad

La Stedion Loyalty API se sitúa frente a la plataforma de lealtad y le da a tu equipo endpoints por usuario para desafíos, recompensas, cupones, perfil y niveles. Autentica con tus propios JWTs, olvídate de firmar requests y construye tu UI, más rápido. Es la misma API sobre la que está construido el Loyalty SDK.

GET /v1/members/me200 OK

      

Respuestas ilustrativas. El miembro se identifica con tu JWT: sin IDs de miembro en las URLs y sin firmar requests.

Qué obtienes

Por usuario, así que lo difícil ya está resuelto

Cada endpoint responde por el miembro que hace la petición: qué puede ver, ganar y canjear. La elegibilidad, la segmentación y la agregación ocurren detrás de la API, así que tu front end se lee como el producto que estás construyendo, no como plomería de plataforma.

Perfil y niveles

Saldo, nivel, progreso al siguiente nivel y registro en una sola llamada.

GET /v1/members/me

Desafíos

Desafíos disponibles, en curso y completados, ya filtrados para el miembro.

GET /v1/members/me/challenges

Recompensas y cupones

La tienda que el miembro puede pagar y para la que califica, más su cartera de cupones.

GET /v1/members/me/rewards

Acciones del miembro

Completa desafíos, canjea recompensas y registra actividad con POSTs simples.

POST /v1/members/me/actions

Historial de actividad

Todo lo ganado y canjeado, paginado y filtrable, listo para una pantalla de historial.

GET /v1/members/me/activities

Tu autenticación JWT

La API confía en los tokens que emite tu backend. Mantienes el control total de la autenticación y nunca hay secretos en el cliente.

Rendimiento a escala

Servida desde el edge

Una llamada agregada devuelve saldo, nivel, desafíos y recompensas desde una caché edge cercana a tus miembros. TTLs cortos mantienen las campañas dinámicas, los webhooks devuelven los cambios a la caché en lugar de hacer polling, y la propia plataforma de lealtad recibe una fracción del tráfico.

Agregada por diseño

Saldo, nivel, desafíos y recompensas en una sola respuesta, no en cuatro viajes.

Cacheada en el edge

Las respuestas llegan desde el edge cercano al miembro, con TTLs cortos que mantienen las campañas dinámicas.

Webhooks, no polling

Los cambios vuelven a la caché en cuanto ocurren; las campañas se activan en segundos.

Amable con la plataforma

La plataforma de lealtad recibe una fracción del tráfico, lo que mantiene predecibles los límites y los costos.

¿API o SDK?

Elige por funcionalidad, no para siempre

El Loyalty SDK está construido sobre esta API, así que ambos coexisten sin fricción. Muchos equipos colocan widgets para los momentos estándar, como un saldo de puntos o una tienda de recompensas, y usan la API directamente donde la experiencia es únicamente suya. Empieza como prefieras y combina niveles según la funcionalidad.

Usa la API cuando…

El momento de lealtad está profundamente tejido en tu propia UI, tienes opiniones firmes de diseño o estás integrando lealtad en superficies que el SDK aún no cubre.

Usa el SDK cuando…

Quieres el camino más rápido a producción: momentos de lealtad estándar, tu identidad visual y actualizaciones centralizadas desde Stedion sin otro release.

Construye tu UI, más rápido

Cuéntanos sobre tu stack. Recorreremos los endpoints con tu programa, en vivo.

Habla con Stedion Explora el Loyalty SDK