Histórico de heartbeats
GET/tenants/{id}/connections/{connId}/heartbeats
O histórico de disponibilidade da conexão em intervalos de meia hora alinhados ao relógio, do mais antigo ao mais recente; o último é o intervalo atual, ainda parcial. Em cada intervalo, ok é false se algum heartbeat falhou, true se só houve sucessos e null sem dados. Escopo necessário: connections:read.
Parâmetros de caminho
idstring · uuidobrigatórioIdentificador do projeto (tenantId).
connIdstring · uuidobrigatórioIdentificador da conexão (o número) no projeto.
Parâmetros de consulta
hoursintegerQuantas horas de histórico, contando o intervalo atual: de 1 a 168 (7 dias).
mínimo 1máximo 168padrão: 24
Respostas
| Código | Erro e descrição |
|---|---|
| 200 | Os intervalos em buckets (start e ok) e uptimePct. |
| 400 | FST_ERR_VALIDATIONhours não é um inteiro de 1 a 168, ou id ou connId não é um UUID; message diz o que está errado. |
| 401 | Sem chave de API, ou com uma chave desconhecida, revogada ou expirada. A chave de um projeto desativado também responde 401. |
| 403 | A chave não tem o escopo connections:read; a mensagem de erro cita o escopo que falta. |
| 404 | O projeto ou a conexão não existe, ou não é de quem chama (Tenant not found, Connection not found). A conexão precisa ser do projeto do caminho. |
| 429 | Requisições demais deste IP de origem, ou autenticações com falha demais: espere os segundos de Retry-After. Veja Limites.Cabeçalho: Retry-After |
Detalhes
São hours × 2 intervalos. uptimePct é a porcentagem dos intervalos com dados em que nenhum heartbeat falhou, com uma casa decimal; null quando nenhum intervalo tem dados.
Guia: Projetos e conexões
Esta página ajudou? · Atualizado em 28 set 2026