Utilitarios

Endpoints chicos que no encajan en otra parte — health checks, sondas de identidad, helpers de sandbox y cambio de locale.

GET /me — sonda de identidad

Devuelve el tenant al que resuelve la API key actual. Usalo como smoke test antes de iniciar el flujo de booking — un 401 acá significa que la key está mal o fue rotada.

Request

bash

curl -s https://greenflow.live/api/v1/me \
  -H "Authorization: Bearer gfc_7s2wprmy_DWTZRBGBEV6La4dTOoFdMkEhWmWCsXdwc3zVMnqP"

Response

json

{
  "client": {
    "id": 1,
    "name": "Movix (demo)",
    "slug": "movix"
  }
}

GET /ping — health check

Sonda de liveness sin autenticación. Devuelve la hora del servidor en ISO-8601 para que las herramientas de monitoreo también puedan medir clock drift.

bash

curl -s https://greenflow.live/api/v1/ping

json

{"pong": "2026-04-19T12:34:56+00:00"}

GET /sandbox/defaults — defaults inteligentes por marca

Región por defecto por vendor (país + ciudad + place_uuid). Consumido por la UI del Sandbox para precargar el campo de retiro. Intencionalmente inestable — no es parte del contrato público — pero útil para prototipar.

bash

curl -s "https://greenflow.live/api/v1/sandbox/defaults?brand=11" \
  -H "Authorization: Bearer gfc_7s2wprmy_DWTZRBGBEV6La4dTOoFdMkEhWmWCsXdwc3zVMnqP"

json

{
  "vendor": "LOCALIZA",
  "country": "BR",
  "city": "São Paulo",
  "lat": -23.5557714,
  "lng": -46.6395571,
  "place_uuid": "d4fb7714-3c40-41bd-b46c-f37f84fe11c3",
  "place_name": "São Paulo"
}

Cambio de locale

Pasá X-Locale o `?lang=` para traducir strings visibles al usuario (nombres de tarifas, oficinas, países) a `en | es | pt`. El header HTTP Accept-Language también se respeta. El locale se mete en la cache key, así que un request `pt` se cachea separado de `en`.

bash

# Switch to Portuguese via header:
curl -s https://greenflow.live/api/v1/me \
  -H "Authorization: Bearer gfc_7s2wprmy_DWTZRBGBEV6La4dTOoFdMkEhWmWCsXdwc3zVMnqP" \
  -H "X-Locale: pt"

# Or via query string:
curl -s "https://greenflow.live/api/v1/me?lang=es" \
  -H "Authorization: Bearer gfc_7s2wprmy_DWTZRBGBEV6La4dTOoFdMkEhWmWCsXdwc3zVMnqP"

# Or via Accept-Language:
curl -s https://greenflow.live/api/v1/me \
  -H "Authorization: Bearer gfc_7s2wprmy_DWTZRBGBEV6La4dTOoFdMkEhWmWCsXdwc3zVMnqP" \
  -H "Accept-Language: pt-BR"

Errores

HTTP	Body	Causa
401	{"message": "Invalid API key"}	/me without a valid token (/ping is public).
422	{"message": "Unknown brand."}	/sandbox/defaults with an unknown brand id.