# API

**Ocean-API** Eine RESTful-API für Scan-Daten, Nutzerinformationen, Risikowerte und Erkennungssysteme. Authentifizierte Aufrufe sind auf 1.000 Anfragen pro Stunde begrenzt.

HTML version: https://anticheat.ac/de/docs/api

## Voraussetzungen

Die API erfordert eine aktive Lizenz oder eine Enterprise-Mitgliedschaft. Kostenlose Nutzer können keine API-Schlüssel erstellen. Einzige Ausnahme ist /v1/version, die öffentlich ist.

- **Basis-URL**: https://api.anticheat.ac/v1
- **Authentifizierung**: Header x-api-key
- **Ratenlimit**: 1.000 Anfragen/Stunde
- **Server-Label**: Optionaler Header x-server-name

## Nutzungsprotokollierung

Jeder authentifizierte Aufruf wird erfasst – Schlüsselpräfix, Endpunkt, IP und Servername – und 90 Tage lang aufbewahrt, um Schlüsselweitergabe und Missbrauch zu erkennen. Vollständige Schlüssel werden nie gespeichert.

## Endpunkte

- [Gescannte Nutzer](https://anticheat.ac/de/docs/api/scanned-users): Vollständiger Scan-Verlauf, Erkennungen, Ban-/Warn-Status und verknüpfte Accounts für einen Discord-Nutzer.
- [Risikowert des Nutzers](https://anticheat.ac/de/docs/api/user-risk-score): Aggregierter Risikowert und Stufe über alle verknüpften Profile.
- [PIN-Ergebnisse](https://anticheat.ac/de/docs/api/pins): Vollständige Scan-Ergebnisse für PINs, die deinem Account gehören.
- [PIN-Status](https://anticheat.ac/de/docs/api/pin-status): Scan-Fortschritt in Echtzeit, Statusprozent und Ergebniszusammenfassung.
- [PINs erstellen](https://anticheat.ac/de/docs/api/pins-create): Scan-PINs programmatisch erstellen. Nur für Enterprise-Owner.
- [Cheater-Datenbank](https://anticheat.ac/de/docs/api/database): Community-Profil, Netzwerkabfrage und Ocean-Scan-Treffer per Discord-ID. Erfordert DB-Zugriff.
- [Version](https://anticheat.ac/de/docs/api/version): Die aktuell aktive Ocean-Client-Version. Öffentlich, kein Schlüssel nötig.
- [MCP-Server](https://anticheat.ac/de/docs/api/mcp): Remote-MCP-Server, der dieselben Daten wie die REST-API per Streamable HTTP für KI-Agenten bereitstellt. OAuth 2.1 mit PKCE – kein API-Schlüssel.

## Risikostufen

| Stufe | Wert | Bedeutung |
| --- | --- | --- |
| clean | 0 | Keine Erkennungen oder verdächtige Aktivität |
| low | 1–25 | Geringfügige Markierungen, wahrscheinlich Fehlalarme |
| medium | 26–50 | Einige verdächtige Aktivitäten erkannt |
| high | 51–75 | Mehrere Erkennungen, wahrscheinlich Cheating |
| critical | 76–100 | Bestätigtes Cheating mit umfangreichem Verlauf |

## Documentation pages

- [API](https://anticheat.ac/de/docs/api)
- [Gescannte Nutzer](https://anticheat.ac/de/docs/api/scanned-users)
- [Nutzer-Risikowert](https://anticheat.ac/de/docs/api/user-risk-score)
- [PINs](https://anticheat.ac/de/docs/api/pins)
- [PIN-Status](https://anticheat.ac/de/docs/api/pin-status)
- [PINs erstellen](https://anticheat.ac/de/docs/api/pins-create)
- [Cheater-Datenbank](https://anticheat.ac/de/docs/api/database)
- [Version](https://anticheat.ac/de/docs/api/version)
- [MCP](https://anticheat.ac/de/docs/api/mcp)

## Markdown pages

- [Ocean Anti-Cheat](https://anticheat.ac/md/de)
- [Preise](https://anticheat.ac/md/de/pricing)
- [Herunterladen](https://anticheat.ac/md/de/downloads)
- [Dokumentation](https://anticheat.ac/md/de/docs)
- [Erkennungen](https://anticheat.ac/md/de/docs/detections)
- [Full reference for language models](https://anticheat.ac/llms-full.txt)