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.
Ähnliche Themen
- API Endpoints: Die authentifizierten Request-Endpoints
- Authentication: Authentifizierung für den Rest der API
- Common Issues: Request-Fehler debuggen