# Endpoint prüfen

> URL: https://foura.ai/de/docs/api/inspect
> Updated: 2026-09-30
> Index: https://foura.ai/llms.txt

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.

```bash
curl https://eu.api.foura.ai/inspect
```

## Response

```json
{
  "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](https://foura.ai/docs/api/endpoints) 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](https://foura.ai/docs/api/endpoints): Die authentifizierten Request-Endpoints
- [Authentication](https://foura.ai/docs/getting-started/authentication): Authentifizierung für den Rest der API
- [Common Issues](https://foura.ai/docs/troubleshooting/common-issues): Request-Fehler debuggen
