Consultar proxy
GET/connections/{id}/proxy
O proxy próprio da conexão, pelo qual saem o socket do WhatsApp e os uploads e downloads de mídia dela, sem as credenciais, e onde a última verificação o viu sair. Escopo necessário: connections:read.
Parâmetros de caminho
idstring · uuidobrigatórioIdentificador da conexão (o número).
Respostas
| Código | Erro e descrição |
|---|---|
| 200 | O proxy da conexão (proxy), ou {"proxy": null} quando ela não tem proxy próprio. |
| 400 | FST_ERR_VALIDATIONA requisição não segue o schema da operação (por exemplo, um id que não é um UUID); message diz o que está errado. |
| 401 | Sem chave de API, ou com uma chave desconhecida, revogada ou expirada. O corpo é {"error": "Unauthorized"}. |
| 403 | A chave não tem o escopo connections:read; a mensagem de erro cita o escopo que falta. |
| 404 | A conexão não existe ou não é de quem chama: a de outra pessoa responde exatamente como uma que não existe (Connection not found). |
| 429 | Requisições demais deste IP de origem, ou autenticações com falha demais: espere os segundos de Retry-After.Cabeçalho: Retry-After |
| 500 | O proxy gravado não pode ser aberto (as credenciais guardadas não abrem com a chave de criptografia do gateway); quem opera o gateway precisa corrigir. |
Detalhes
proxy traz scheme, host, port, hasCredentials (se a URL tem usuário e senha) e country (o país exigido na verificação antes do pareamento; null: qualquer um). A URL e as credenciais nunca voltam. proxy é null quando a conexão não tem proxy próprio.
exit é onde a última verificação pelo proxy o viu sair: ip (o IP em que o WhatsApp vê o número), country (ISO 3166-1 alfa-2, ou null quando o serviço de IP não informa) e checkedAt.
Guia: Proxy e IP dedicado
Esta página ajudou? · Atualizado em 28 set 2026