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.
Contenido relacionado
- API Endpoints: Los endpoints de request autenticados
- Authentication: Cómo autenticar el resto de la API
- Common Issues: Depurar fallos de requests