Endpoint de Inspeção

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"
}

Top-Level Fields

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	Timestamp 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 dos seguintes: `transparent`, `anonymous`, `distorting`, `none`
`anonymityLevel`	string	Um dos seguintes: `transparent`, `anonymous`, `none`
`confidence`	string	Confiança da detecção: `high`, `medium` ou `low`
`detectedHeaders`	string[]	Nomes de cabeçalhos que indicaram um proxy (ex.: `via`, `forwarded`)
`explanation`	string	Resumo em texto simples do resultado

`proxyChain`

Campo	Tipo	Descrição
`originalClientIp`	string	Igual ao `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 Isto

Confirmar que seu tráfego de saída não está passando por um proxy corporativo ou túnel inesperado.
Depurar por que seu IP real aparece nos logs do site de destino mesmo quando você acreditava estar anônimo.
Verificar se um proxy residencial ou rotativo está mascarando sua origem antes de enviar requisições pagas através da FourA.

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

Limites

Nenhuma autenticação é necessária.
Sujeito a um rate limit público generoso. Se você fizer chamadas mais de algumas vezes por segundo a partir do mesmo IP, espere limitação de taxa (throttling).
A resposta reflete apenas cabeçalhos e IPs. Ela não consegue detectar um proxy elite perfeitamente transparente que remove todos os cabeçalhos de proxy.

Relacionados

API Endpoints: Os endpoints de requisição autenticados
Authentication: Como autenticar o restante da API
Common Issues: Depuração de falhas de requisição

Atualizado em: 30 de setembro de 2026