Endpoint prüfen

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 erforderlich.

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 Ursprüngliche Client-IP (erste Adresse links in der Weiterleitungskette)
proxyDetection object Proxy-Erkennung und Anonymitätsanalyse
proxyChain object Aufschlüsselung der clientseitigen IP-Kette
timestamp string ISO-8601-Zeitstempel der Request-Überprüfung

proxyDetection

Feld Typ Beschreibung
isProxy boolean True, wenn clientseitige Proxy-Header erkannt wurden
proxyType string Einer der Werte: transparent, anonymous, distorting, none
anonymityLevel string Einer der Werte: transparent, anonymous, none
confidence string Erkennungszuverlässigkeit: high, medium oder low
detectedHeaders string[] Header-Namen, die auf einen Proxy hinweisen (z. B. via, forwarded)
explanation string Zusammenfassung des Ergebnisses im Klartext

proxyChain

Feld Typ Beschreibung
originalClientIp string Identisch mit clientIp auf Top-Level-Ebene
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
none Keine Proxy-Header gefunden: direkte Verbindung oder ein Proxy, der keine sendet

Typische Anwendungsfälle

  • Prüfe, ob dein ausgehender Traffic unerwartet über einen Unternehmens-Proxy oder einen Tunnel läuft.
  • Finde heraus, warum deine echte IP in den Logs der Zielseite erscheint, obwohl du anonym sein wolltest.
  • Stelle sicher, dass ein Residential- oder rotierender Proxy deinen Ursprung maskiert, bevor du kostenpflichtige Requests über FourA sendest.

Dieser Endpoint prüft deine Verbindung zu FourA. Er testet nicht das Proxy-Netzwerk von FourA selbst. 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 ihn mehrmals pro Sekunde von derselben IP aufrufst, musst du mit Throttling rechnen.
  • Die Response spiegelt nur Header und IPs wider. Ein vollkommen transparenter Elite-Proxy, der alle Proxy-Header entfernt, kann nicht erkannt werden.
Aktualisiert: 30. September 2026