Endpoint de Inspeção
Um endpoint de diagnóstico público que retorna o seu IP de 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 Principais
| Campo | Tipo | Descrição |
|---|---|---|
clientIp |
string | IP do cliente original (o endereço mais à esquerda na cadeia de encaminhamento) |
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 o request foi inspecionado |
proxyDetection
| Campo | Tipo | Descrição |
|---|---|---|
isProxy |
boolean | True se headers de proxy do lado do cliente foram detectados |
proxyType |
string | Um de: transparent, anonymous, distorting, elite, none |
anonymityLevel |
string | Um de: transparent, anonymous, elite, none |
confidence |
string | Confiança da detecção: high, medium ou low |
detectedHeaders |
string[] | Nomes de headers que sinalizaram um proxy (ex: via, forwarded) |
explanation |
string | Resumo em texto simples do resultado |
proxyChain
| Campo | Tipo | Descrição |
|---|---|---|
originalClientIp |
string | O mesmo que o clientIp de alto nível |
proxyChain |
string[] | Lista de IPs de proxy entre você e o FourA, se houver |
proxyCount |
number | Número de proxies detectados na cadeia (0 = direto) |
via |
string[] | Conteúdo do header Via, se presente |
hasPrivateIps |
boolean | True se algum IP privado ou 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 |
elite |
Sem headers de proxy, parece uma conexão direta |
none |
Nenhum proxy do lado do cliente detectado |
Quando Usar
- Confirmar se o seu tráfego de saída não está passando por um proxy corporativo ou VPN inesperado.
- Depurar por que seu IP real aparece nos logs do site de destino mesmo quando você achava que estava anônimo.
- Verificar se um proxy residencial ou rotativo está mascarando sua origem antes de enviar requests pagos através do FourA.
Este endpoint inspeciona a sua conexão com o FourA. Ele não testa a própria rede de proxy do FourA. Para verificar de qual IP vem um request roteado pelo FourA, use o Proxy endpoint e leia a response.
Limites
- Nenhuma autenticação é necessária.
- Sujeito a um rate limit público generoso. Se você chamá-lo mais de algumas vezes por segundo a partir do mesmo IP, espere limitação de taxa.
- A response reflete apenas headers e IPs. Ela não consegue detectar um proxy elite perfeitamente transparente que remove todos os headers de proxy.
Relacionado
- API Endpoints: Os endpoints de request autenticados
- Authentication: Como autenticar o restante da API
- Common Issues: Depurar falhas de request