Inspect-Endpoint

Ein öffentlicher Diagnose-Endpoint, der deine Client-IP und Details zur Proxy-Erkennung zurückgibt. Nutze ihn, um zu prüfen, ob dein ausgehender Traffic über einen Proxy läuft, bevor du Requests über FourA sendest.

Request

GET /inspect

Dieser Endpoint ist öffentlich. Kein API-Key, kein X-API-Key-Header.

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	Ursprüngliche Client-IP (am weitesten links stehende Adresse in der Forwarded-Kette)
`proxyDetection`	object	Proxy-Erkennung und Anonymitätsanalyse
`proxyChain`	object	Aufschlüsselung der clientseitigen IP-Kette
`timestamp`	string	ISO 8601-Zeitstempel der Request-Prüfung

`proxyDetection`

Field	Type	Description
`isProxy`	boolean	True, wenn clientseitige Proxy-Header erkannt wurden
`proxyType`	string	Einer von: `transparent`, `anonymous`, `distorting`, `none`
`anonymityLevel`	string	Einer von: `transparent`, `anonymous`, `none`
`confidence`	string	Erkennungskonfidenz: `high`, `medium` oder `low`
`detectedHeaders`	string[]	Header-Namen, die auf einen Proxy hinweisen (z. B. `via`, `forwarded`)
`explanation`	string	Zusammenfassung des Ergebnisses in einfachem Text

`proxyChain`

Field	Type	Description
`originalClientIp`	string	Identisch mit Top-Level-Feld `clientIp`
`proxyChain`	string[]	Liste der Proxy-IPs zwischen dir und FourA, falls vorhanden
`proxyCount`	number	Anzahl der erkannten Proxys in der Kette (0 = direkt)
`via`	string[]	Inhalt des `Via`-Headers, falls vorhanden
`hasPrivateIps`	boolean	True, wenn private/interne IPs in der Kette vorkommen

Proxy-Typen

Typ	Bedeutung
`transparent`	Leitet deine echte IP weiter und gibt sich als Proxy zu erkennen
`anonymous`	Verbirgt deine echte IP, gibt sich aber als Proxy zu erkennen
`distorting`	Sendet eine gefälschte Client-IP an das Ziel
`none`	Keine Proxy-Header erkannt: direkte Verbindung oder ein Proxy, der keine Header sendet

Typische Anwendungsfälle

Sicherstellen, dass dein ausgehender Datenverkehr nicht unerwartet über einen Unternehmensproxy oder Tunnel läuft.
Analysieren, warum deine echte IP in Zielserver-Logs auftaucht, obwohl du anonym sein solltest.
Überprüfen, ob ein Residential- oder Rotating-Proxy deine Herkunft verschleiert, bevor du kostenpflichtige Requests über FourA sendest.

Dieser Endpoint prüft deine Verbindung zu FourA. Er testet nicht das eigene Proxy-Netzwerk von FourA. Um zu prüfen, von welcher IP ein über FourA gerouteter Request stammt, nutze den Proxy-Endpoint und lies die Response aus.

Limits

Keine Authentifizierung erforderlich.
Unterliegt einem großzügigen öffentlichen Rate Limit. Bei mehr als ein paar Aufrufen pro Sekunde von derselben IP greift Throttling.
Die Response spiegelt nur Header und IPs wider. Ein vollständig transparenter Elite-Proxy, der alle Proxy-Header entfernt, kann nicht erkannt werden.