Mi cuenta

Todo lo que necesita el primer render: los datos del usuario, sus puntos, la marca del comercio y los puntos por vencer.

GET/v1/meToken del usuario

Todo lo que necesita el frontend en el primer render: los datos del usuario, sus puntos y adhesión en el programa del comercio indicado en X-Commerce-Id, los datos de marca del comercio (nombre, logo, color, rubro) y los puntos que están por vencer.

Es la llamada con la que arranca la app. No hace falta pedir los datos del comercio aparte: vienen dentro.

Headers

X-Commerce-Idintegerheaderrequerido

Id del comercio que integra la API. Todas las respuestas quedan limitadas a este comercio.

Respuesta

Un objeto Mi cuenta.

curl https://loybox-public-api-752998171300.southamerica-west1.run.app/v1/me \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H "X-Commerce-Id: 87"
// 200 OK
{
  "username": "Ana Pérez",
  "email": "ana@example.com",
  "phone": null,
  "points": 340,
  "subscribed": true,
  "commerce": {
    "id": 87,
    "name": "Tienda Central",
    "logo": "https://cdn.loybox.com.ar/logos/87.png",
    "color": "#f1a10d",
    "category_name": "Tienda de comics",
    "currency": "ARS"
  },
  "points_expiration": {
    "points": 120,
    "expiration_date": "2026-09-30T23:59:59Z",
    "days_left": 37,
    "months_left": 1,
    "mode": "accumulated"
  }
}

Qué hacer con cada pieza:

CampoPara qué
pointsEl saldo grande de la pantalla. Es con lo que se compara el cost de cada beneficio.
subscribedSi viene en false, mostrá el llamado a adherirse en lugar del catálogo.
commerceLogo, nombre y color para pintar la marca del programa.
points_expirationEl aviso de "te vencen X puntos en Y días".

Cuando los puntos no vencen

points_expiration no viene en null: viene con mode: "none" y points: 0. Chequeá el mode antes de mostrar el aviso de vencimiento.

Errores

CódigoCuándo
401El token de acceso falta, venció o no corresponde a un usuario final.
422Falta el header X-Commerce-Id.