Ocean API

Ocean bietet eine RESTful API für den programmatischen Zugriff auf Scan-Daten, Nutzerinformationen, Risikowerte und Erkennungssysteme. Alle Endpunkte verwenden API-Schlüssel zur Authentifizierung und sind auf 1.000 Anfragen pro Stunde begrenzt.

Voraussetzungen

Die Ocean API ist nur für Nutzer mit einer aktiven Lizenz oder Enterprise-Mitgliedschaftverfügbar. Kostenlose Nutzer können keine API-Schlüssel erstellen oder verwenden.

Die einzige Ausnahme ist /v1/versiondie öffentlich ist und keinen API-Schlüssel benötigt.

Basis-URL: https://api.anticheat.ac/v1
Authentifizierung: Übergib deinen API-Schlüssel über den Header x-api-key
Optional: Sende x-server-name um zu kennzeichnen, welcher deiner Server den Aufruf gemacht hat

Verfügbare Endpunkte

GET/v1/scanned-users/lookup/:discordIdVollständigen Scan-Verlauf, Erkennungen, Bann-/Warnstatus und verwandte Konten eines Discord-Nutzers abfragenBerechtigung: scanned-users:lookupGET/v1/users/:discordId/risk-scoreBerechneten Risikowert und die Stufe eines Discord-Nutzers abrufenBerechtigung: user:risk-scoreGET/v1/pins/:pinCode/resultsRufe die Scan-Ergebnisse deiner eigenen PINs programmatisch abBerechtigung: pins:resultsGET/v1/pins/:pinCode/statusScan-Fortschritt in Echtzeit, Statusprozentsatz und Ergebniszusammenfassung für deine PINs abrufenBerechtigung: pins:statusPOST/v1/pins/createErstelle Scan-PINs programmatisch per API. Nur für Enterprise-Eigentümer.Berechtigung: pins:create(Enterprise-Eigentümer)GET/v1/db/query/:discordIdCheater-Datenbank per Discord-ID durchsuchen: Community-Profil, Netzwerkabfrage und Ocean-Scan-TrefferBerechtigung: db:query(DB-Zugriff)GET/v1/versionLies die aktuell aktive Ocean-Client-Version aus. Ideal für einen VersionsprüferBerechtigung: keine, dieser Endpunkt ist öffentlich MCPhttps://api.anticheat.ac/mcpRemote-MCP-Server, der dieselben Daten wie die REST API per Streamable HTTP für KI-Agenten bereitstelltAuthentifizierung: OAuth 2.1

Nutzungsprotokollierung

Jeder authentifizierte API-Aufruf wird aufgezeichnet: welcher Schlüssel verwendet wurde, welchen Endpunkt er aufgerufen hat, die IP des Aufrufers und der optionale x-server-name -Header. Die Protokolle werden 90 Tage aufbewahrt und dienen dazu, Schlüsselweitergabe und Missbrauch zu erkennen. Sie enthalten nie den vollständigen API-Schlüssel, nur seine ersten 12 Zeichen.

Wenn ein Schlüssel mehrere Server bedient, sende von jedem einen eigenen x-server-name Das ist der schnellste Weg, um zu zeigen, welcher Server einen bestimmten Aufruf gemacht hat.

Rate-Limiting

Alle API-Endpunkte teilen sich ein globales Rate-Limit von 1.000 Anfragen pro Stunde pro API-Schlüssel. Rate-Limit-Header (X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset) sind in jeder Antwort enthalten.