Endpoint Inspect

Un endpoint de diagnóstico público que devuelve su IP de cliente y detalles de detección de proxy. Utilícelo para verificar si su tráfico saliente pasa por un proxy antes de comenzar a enviar requests a través de FourA.

Request

GET /inspect

Este endpoint es público. Sin API key, sin 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 nivel superior

Field	Type	Description
`clientIp`	string	IP de cliente original (la dirección más a la izquierda en la cadena reenviada)
`proxyDetection`	object	Detección de proxy y análisis de anonimato
`proxyChain`	object	Desglose de la cadena de IP del lado del cliente
`timestamp`	string	Timestamp ISO 8601 de cuándo se inspeccionó el request

`proxyDetection`

Field	Type	Description
`isProxy`	boolean	Verdadero si se detectaron headers de proxy del lado del cliente
`proxyType`	string	Uno de: `transparent`, `anonymous`, `distorting`, `elite`, `none`
`anonymityLevel`	string	Uno de: `transparent`, `anonymous`, `elite`, `none`
`confidence`	string	Confianza de detección: `high`, `medium` o `low`
`detectedHeaders`	string[]	Nombres de header que señalaron un proxy (por ejemplo, `via`, `forwarded`)
`explanation`	string	Resumen en inglés sencillo del resultado

`proxyChain`

Field	Type	Description
`originalClientIp`	string	Igual que `clientIp` de nivel superior
`proxyChain`	string[]	Lista de IPs de proxy entre usted y FourA, si las hay
`proxyCount`	number	Número de proxies detectados en la cadena (0 = directo)
`via`	string[]	Contenido del header `Via`, si está presente
`hasPrivateIps`	boolean	Verdadero si aparece alguna IP privada o interna en la cadena

Tipos de Proxy

Type	What it means
`transparent`	Reenvía su IP real y se identifica como un proxy
`anonymous`	Oculta su IP real pero se identifica como un proxy
`distorting`	Envía una IP de cliente falsa al destino
`elite`	Sin headers de proxy, parece una conexión directa
`none`	No se detectó ningún proxy del lado del cliente

Cuándo usar esto

Confirmar que su tráfico saliente no esté pasando por un proxy corporativo o VPN que no esperaba.
Depurar por qué su IP real aparece en los logs del sitio de destino incluso cuando pensaba que era anónimo.
Verificar que un proxy residencial o rotativo esté enmascarando su origen antes de enviar requests de pago a través de FourA.

Este endpoint inspecciona su conexión a FourA. No prueba la propia red de proxies de FourA. Para verificar de qué IP proviene un request enrutado por FourA, use el endpoint Proxy y lea la response.

Límites

No requiere autenticación.
Sujeto a un rate limit público generoso. Si lo llama más de unas pocas veces por segundo desde la misma IP, espere throttling.
La response refleja solo headers e IPs. No puede detectar un proxy elite perfectamente transparente que elimine todos los headers de proxy.

Relacionado

Endpoints de API: Los endpoints de request autenticados
Autenticación: Cómo autenticar el resto de la API
Problemas comunes: Depurar fallas de request

Actualizado: 29 de abril de 2026