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"
}
Top-Level Fields
| Field | Type | Description |
|---|---|---|
clientIp |
string | IP original del cliente (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 | Marca de tiempo ISO 8601 de cuándo se inspeccionó la solicitud |
proxyDetection
| Field | Type | Description |
|---|---|---|
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 | Confianza de la detección: high, medium, o low |
detectedHeaders |
string[] | Nombres de los headers que señalaron un proxy (p. ej. via, forwarded) |
explanation |
string | Resumen en lenguaje claro del resultado |
proxyChain
| Field | Type | Description |
|---|---|---|
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 | Cantidad 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/interna en la cadena |
Proxy Types
| Type | What it means |
|---|---|
transparent |
Reenvía tu IP real y se identifica como un proxy |
anonymous |
Oculta tu IP real pero se identifica como un 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
- Confirma que tu tráfico saliente no pase por un proxy corporativo o túnel inesperado.
- Depura por qué tu IP real aparece en los logs del sitio de destino incluso cuando pensabas que eras anónimo.
- Verifica que un proxy residencial o rotativo esté enmascarando tu origen antes de enviar solicitudes pagas mediante FourA.
Este endpoint inspecciona tu conexión a FourA. No prueba la propia red de proxies de FourA. Para verificar de qué IP proviene una solicitud enrutada por FourA, usa el endpoint Proxy y lee la respuesta.
Límites
- No se requiere autenticación.
- Sujeto a un rate limit público generoso. Si realizas llamadas más de unas pocas veces por segundo desde la misma IP, espera una limitación de tráfico.
- La respuesta refleja únicamente headers e IPs. No puede detectar un proxy de élite perfectamente transparente que elimine todos los headers de proxy.
Relacionado
- Endpoints de la API: Los endpoints de solicitudes autenticadas
- Autenticación: Cómo autenticar el resto de la API
- Problemas comunes: Depurar fallos en las solicitudes