Utilitários

Endpoints pequenos que não encaixam em outro lugar — health checks, sondas de identidade, helpers de sandbox e troca de locale.

GET /me — sonda de identidade

Retorna o tenant ao qual a API key atual resolve. Use como smoke test antes de iniciar o fluxo de booking — um 401 aqui significa que a key está errada ou foi rotacionada.

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 sem autenticação. Retorna a hora do servidor em ISO-8601 para que ferramentas de monitoramento também possam medir clock drift.

bash

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

json

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

GET /sandbox/defaults — padrões inteligentes por marca

Região padrão por vendor (país + cidade + place_uuid). Consumida pela UI do Sandbox para preencher previamente o campo de retirada. Intencionalmente instável — não faz parte do contrato público — mas ú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"
}

Troca de locale

Passe X-Locale ou `?lang=` para traduzir strings visíveis (nomes de tarifas, lojas, países) para `en | es | pt`. O header HTTP Accept-Language também é respeitado. O locale entra na chave de cache, então um request `pt` é cacheado 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"

Erros

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.