Endpoint Inspect

Un endpoint de diagnóstico público que devuelve tu IP de cliente y los detalles de detección de proxy. Úsalo para verificar si tu tráfico saliente pasa por un proxy antes de empezar 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

Campo Tipo Descripción
clientIp string IP original del cliente (dirección situada más a la izquierda en la cadena de reenvío)
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 Marca de tiempo ISO 8601 de cuándo se inspeccionó la request

proxyDetection

Campo Tipo Descripción
isProxy boolean True si se detectaron headers de proxy del lado del cliente
proxyType string Uno de: transparent, anonymous, distorting, none
anonymityLevel string Uno de: transparent, anonymous, none
confidence string Nivel de confianza de la detección: high, medium o low
detectedHeaders string[] Nombres de headers que indicaron un proxy (p. ej. via, forwarded)
explanation string Resumen en lenguaje sencillo del resultado

proxyChain

Campo Tipo Descripción
originalClientIp string Igual que el clientIp de nivel superior
proxyChain string[] Lista de IPs de proxy entre tú 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 True si aparece alguna IP privada o interna en la cadena

Tipos de proxy

Tipo Qué significa
transparent Reenvía tu IP real y se identifica como proxy
anonymous Oculta tu IP real pero se identifica como proxy
distorting Envía una IP de cliente falsa al destino
none No se observan headers de proxy: una conexión directa, o un proxy que no envía ninguno

Cuándo usar esto

  • Confirmar que tu tráfico saliente no está pasando por un proxy corporativo o un túnel que no esperabas.
  • Depurar por qué tu IP real aparece en los logs del sitio de destino incluso cuando creías que estabas navegando de forma anónima.
  • Verificar que un proxy residencial o rotativo está enmascarando tu origen antes de enviar requests de pago a través de FourA.

Este endpoint inspecciona tu conexión a FourA. No prueba la red de proxies de FourA. Para verificar de qué IP procede una request enrutada por FourA, usa el Proxy endpoint y lee la response.

Límites

  • No se requiere autenticación.
  • Sujeto a un rate limit público generoso. Si lo llamas más de unas pocas veces por segundo desde la misma IP, se aplicará throttling.
  • La response refleja únicamente headers e IPs. No puede detectar un proxy de élite perfectamente transparente que elimine todos los headers de proxy.
Actualizado: 30 de septiembre de 2026