OmniLink API
Metrics

Snapshot de erros HTTP 5xx da API

Retorna contadores in-memory de respostas >= 500 por path template (`api_error_snapshot` em app/core/metrics.py). Nao persiste entre reinicios. Auth: se METRICS_TOKEN estiver vazio, endpoint fica aberto; caso contrario exige Bearer ou `x-metrics-token`.

GET
/health/diagnostics

Retorna contadores in-memory de respostas >= 500 por path template (api_error_snapshot em app/core/metrics.py). Nao persiste entre reinicios. Auth: se METRICS_TOKEN estiver vazio, endpoint fica aberto; caso contrario exige Bearer ou x-metrics-token.

Authorization

AuthorizationBearer <token>

Token estatico METRICS_TOKEN. Nao e JWT — a API compara a string literal depois de Bearer . Usado so em /metrics e /health/diagnostics. TODO: nao existe autenticacao JWT nesta API.

In: header

Header Parameters

Authorization?string

Bearer METRICS_TOKEN. Ignorado se METRICS_TOKEN do servidor estiver vazio.

x-metrics-token?string

Alternativa ao Authorization Bearer.

Response Body

application/json

application/json

application/json

curl -X GET "https://example.com/health/diagnostics"

{  "api_errors": {}}

Readiness (Postgres + Redis) GET

Executa `SELECT 1` no banco e `PING` no Redis (`celery_broker_url`). Se qualquer check falhar, retorna 503 com `detail.status=unhealthy`.

Metricas Prometheus GET

Expõe `generate_latest()` do prometheus_client (contadores/histogramas HTTP e de tasks). Content-Type: `text/plain; version=0.0.4`. Mesma regra de METRICS_TOKEN que `/health/diagnostics`.