Pular para o conteúdo principal
GET
/
health
curl -X GET "https://ryzeapi.cloud/health"

{
  "status": "ok",
  "service": "RyzeAPI",
  "uptime": "12h34m56s",
  "timestamp": "2026-04-28T14:35:21Z",
  "checks": {
    "db": "ok"
  }
}
Auth: Nenhuma • Rate-limit: Bypass (fora do limite global) • Idempotente: sim

​
Descrição

Endpoint aberto (sem token) que devolve um snapshot do estado da API a partir de checks de dependências (DB sempre, mais probes opcionais como S3 quando configurado). Bypassa rate-limit e CORS para que monitores externos possam consultá-lo sem credenciais.

​
Exemplo

curl -X GET "https://ryzeapi.cloud/health"

​
Resposta, saudável

{
  "status": "ok",
  "service": "RyzeAPI",
  "uptime": "12h34m56s",
  "timestamp": "2026-04-28T14:35:21Z",
  "checks": {
    "db": "ok"
  }
}

​
Resposta, degradado

503 Service Unavailable
{
  "status": "degraded",
  "service": "RyzeAPI",
  "uptime": "12h34m56s",
  "timestamp": "2026-04-28T14:35:21Z",
  "checks": {
    "db": "fail: connection refused"
  }
}

​
Campos

CampoDescrição
status"ok" quando todos os checks passam, "degraded" quando algum falha.
serviceSempre "RyzeAPI".
uptimeTempo desde o boot do processo, no formato Go duration (ex.: 12h34m56s, 1h2m3.456s).
timestampMomento da resposta em RFC 3339 (UTC).
checksMapa nome → "ok" | "fail: <motivo>" para cada dependência verificada.
Entradas em checks aparecem condicionalmente: db está sempre presente; outras dependências (ex.: s3) só aparecem quando configuradas no servidor.

​
Uso em uptime monitors

Aponte um serviço de monitoramento (UptimeRobot, Better Stack, Pingdom, etc.) para GET /health:
  • 200 → API saudável.
  • 503 → API degradada, dispare o alerta.

​
Notas

  • Não é necessário enviar header token. Tokens enviados são ignorados.
  • O endpoint não conta para o limite global de 100 req/min, pode ser chamado sem restrição por probes externas.

​
Relacionados

Visão geral

Posicionamento do endpoint dentro do ciclo de vida da API.

Tipos de erro

Tabela de status HTTP usados pela RyzeAPI.