Pular para o conteúdo

Consultar conexão

GET/tenants/{id}/connections/{connId}

Os detalhes de uma conexão do projeto, com os 50 eventos mais recentes dela, do mais recente ao mais antigo. Os heartbeats bem-sucedidos ficam de fora: eles estão no histórico de heartbeats. Escopo necessário: connections:read.

Ver em Markdown

Parâmetros de caminho

idstring · uuidobrigatório

Identificador do projeto (tenantId).

connIdstring · uuidobrigatório

Identificador da conexão (o número) no projeto.

Respostas

Respostas: código de status, erro e descrição
CódigoErro e descrição
200A conexão e os eventos recentes dela em events, do mais recente ao mais antigo.
400FST_ERR_VALIDATIONid ou connId não é um UUID; message diz o que está errado.
401Sem chave de API, ou com uma chave desconhecida, revogada ou expirada. A chave de um projeto desativado também responde 401.
403A chave não tem o escopo connections:read; a mensagem de erro cita o escopo que falta.
404O 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.
429Requisiçõ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

status é o gravado, em minúsculas (pending, connecting, open, close, failed ou passkey_required). events[].eventType é um de CREATED, QR_GENERATED, QR_SCANNED, CONNECTED, DISCONNECTED, RECONNECTING, RECONNECTED, ERROR, HEARTBEAT_FAILED, SESSION_EXPIRED e LOGGED_OUT, e details traz o contexto de cada evento.

Os eventos de conexão ficam guardados por 30 dias, por padrão.

Guia: Projetos e conexões

Esta página ajudou? · Atualizado em 28 set 2026