Inspect-Endpoint

Ein öffentlicher Diagnose-Endpoint, der deine Client-IP und Details zur Proxy-Erkennung zurückgibt. Nutze ihn, um zu überprü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-Felder

Feld	Typ	Beschreibung
`clientIp`	string	Originale Client-IP (die 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`

Feld	Typ	Beschreibung
`isProxy`	boolean	True, wenn clientseitige Proxy-Header erkannt wurden
`proxyType`	string	Einer von: `transparent`, `anonymous`, `distorting`, `elite`, `none`
`anonymityLevel`	string	Einer von: `transparent`, `anonymous`, `elite`, `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 verständlichem Englisch

`proxyChain`

Feld	Typ	Beschreibung
`originalClientIp`	string	Identisch mit Top-Level `clientIp`
`proxyChain`	string[]	Liste der Proxy-IPs zwischen dir und FourA, falls vorhanden
`proxyCount`	number	Anzahl der in der Kette erkannten Proxys (0 = direkt)
`via`	string[]	Inhalt des `Via`-Headers, falls vorhanden
`hasPrivateIps`	boolean	True, wenn private oder 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
`elite`	Keine Proxy-Header, sieht wie eine direkte Verbindung aus
`none`	Kein clientseitiger Proxy erkannt

Wann du dies nutzen solltest

Bestätigen, dass dein ausgehender Traffic nicht unerwartet über einen Firmen- oder VPN-Proxy läuft.
Debuggen, warum deine echte IP in den Logs der Zielseite auftaucht, obwohl du dachtest, du wärst anonym.
Überprüfen, ob ein Residential- oder rotierender Proxy deine Herkunft maskiert, 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 überprü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. Wenn du den Endpoint mehrmals pro Sekunde von derselben IP aufrufst, musst du mit Throttling rechnen.
Die Response spiegelt nur Header und IPs wider. Sie kann keinen perfekt transparenten Elite-Proxy erkennen, der alle Proxy-Header entfernt.

Siehe auch

API-Endpoints: Die authentifizierten Request-Endpoints
Authentifizierung: So authentifizierst du den Rest der API
Häufige Probleme: Request-Fehler debuggen

Aktualisiert: 29. April 2026