Inspecionar endpoint

Um endpoint público de diagnóstico que retorna o IP do seu cliente e detalhes de detecção de proxy. Use-o para verificar se o seu tráfego de saída está passando por um proxy antes de começar a enviar requests através do FourA.

Request

GET /inspect

Este endpoint é público. Sem API key, sem header X-API-Key.

curl https://eu.api.foura.ai/inspect

Response

{
  "clientIp": "203.0.113.42",
  "proxyDetection": {
    "isProxy": false,
    "proxyType": "none",
    "anonymityLevel": "none",
    "confidence": "medium",
    "detectedHeaders": [],
    "explanation": "Direct connection (no client-side proxy detected). Note: Elite proxies cannot be ruled out without additional data."
  },
  "proxyChain": {
    "originalClientIp": "203.0.113.42",
    "proxyCount": 0,
    "hasPrivateIps": false
  },
  "timestamp": "2026-04-29T08:07:04.683Z"
}

Campos de nível superior

Campo Tipo Descrição
clientIp string IP original do cliente (endereço mais à esquerda na cadeia encaminhada)
proxyDetection object Detecção de proxy e análise de anonimato
proxyChain object Detalhamento da cadeia de IP do lado do cliente
timestamp string Carimbo de data/hora ISO 8601 de quando a requisição foi inspecionada

proxyDetection

Campo Tipo Descrição
isProxy boolean Verdadeiro se cabeçalhos de proxy do lado do cliente foram detectados
proxyType string Um de: transparent, anonymous, distorting, none
anonymityLevel string Um de: transparent, anonymous, none
confidence string Confiança da detecção: high, medium ou low
detectedHeaders string[] Nomes de cabeçalho que indicaram um proxy (por exemplo, via, forwarded)
explanation string Resumo do resultado em texto simples

proxyChain

Campo Tipo Descrição
originalClientIp string Mesmo que o clientIp de nível superior
proxyChain string[] Lista de IPs de proxy entre você e a FourA, se houver
proxyCount number Número de proxies detectados na cadeia (0 = direto)
via string[] Conteúdo do cabeçalho Via, se presente
hasPrivateIps boolean Verdadeiro se algum IP privado/interno aparecer na cadeia

Tipos de proxy

Tipo O que significa
transparent Encaminha seu IP real e se identifica como um proxy
anonymous Oculta seu IP real, mas se identifica como um proxy
distorting Envia um IP de cliente falso para o destino
none Nenhum cabeçalho de proxy visto: uma conexão direta ou um proxy que não envia nenhum

Quando usar isso

  • Confirme se o seu tráfego de saída não está passando por um proxy corporativo ou túnel que você não esperava.
  • Depure por que seu IP real aparece nos logs do site de destino, mesmo quando você achava que estava anônimo.
  • Verifique se um proxy residencial ou rotativo está mascarando sua origem antes de enviar requisições pagas pela FourA.

Este endpoint inspeciona sua conexão com a FourA. Ele não testa a própria rede de proxies da FourA. Para verificar de qual IP se origina uma requisição roteada pela FourA, use o endpoint de proxy e leia a resposta.

Limites

  • Nenhuma autenticação necessária.
  • Sujeito a um limite de taxa público generoso. Se você chamá-lo mais de algumas vezes por segundo a partir do mesmo IP, espere limitação de taxa.
  • A resposta reflete apenas cabeçalhos e IPs. Ela não consegue detectar um proxy de elite perfeitamente transparente que remove todos os cabeçalhos de proxy.
Atualizado em: 30 de setembro de 2026