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.
Relacionado
- Endpoints da API: Os endpoints de requisição autenticada
- Autenticação: Como autenticar o restante da API
- Problemas comuns: Depurar falhas de requisição