Zum Hauptinhalt springen

Version-API

GET /v1/version

Die Version-API stellt die aktuell aktive Ocean-Client-Version bereit. Sie ist der Endpunkt, auf den du einen Versionsprüfer richtest, wenn ein Server, ein Bot oder eine Deployment-Pipeline wissen soll, ob die neueste Version läuft.

Kein API-Schlüssel erforderlich

Dies ist der einzige /v1-Endpunkt, der vollständig öffentlich ist. Die aktive Version ist keine sensible Information, daher braucht ein Versionsprüfer weder Zugangsdaten noch eine Lizenz oder einen API-Schlüssel, um sie zu lesen.

Basis-URL
https://api.anticheat.ac/v1
Authentifizierung
Keine
Rate-Limit
60 Anfragen pro Minute und IP

Aktuelle Version abrufen

Gibt die Version zurück, die derzeit als aktiv markiert ist, zusammen mit ihren Release Notes und dem Veröffentlichungsdatum.

GET/v1/version

Antwort

{
  "version": "2.4.1",
  "releaseNotes": "Added Rust mapped-driver detection and fixed a false positive on Windows 11 24H2.",
  "releasedAt": "2026-08-14T09:12:44.000Z"
}

Antwortfelder

FeldTypBeschreibung
versionstringDie aktuell aktive Versionszeichenfolge
releaseNotesstringRelease Notes der aktiven Version. Leerer String, wenn keine veröffentlicht wurden
releasedAtstringISO-8601-Zeitstempel der Erstellung der Version

Fehler

StatusBedeutung
404Derzeit ist keine Version als aktiv markiert
429Rate-Limit für deine IP-Adresse überschritten

Caching

Die Antwort wird serverseitig 60 Sekunden lang gecacht. Wer häufiger als einmal pro Minute abfragt, erhält dieselbe Antwort, ohne die Datenbank zu belasten; ein Prüfer, der alle paar Minuten läuft, reicht daher völlig aus, um ein neues Release schnell zu erkennen.

Anwendungsbeispiel

cURL

curl -X GET "https://api.anticheat.ac/v1/version"

JavaScript/Node.js

const LOCAL_VERSION = '2.4.0';

const response = await fetch('https://api.anticheat.ac/v1/version');
const data = await response.json();

if (data.version !== LOCAL_VERSION) {
  console.log(`Ocean ${data.version} is available (running ${LOCAL_VERSION})`);
  console.log(data.releaseNotes);
}

Python

import requests

LOCAL_VERSION = '2.4.0'

data = requests.get('https://api.anticheat.ac/v1/version').json()

if data['version'] != LOCAL_VERSION:
    print(f"Ocean {data['version']} is available (running {LOCAL_VERSION})")
    print(data['releaseNotes'])

Lua (FiveM)

local LOCAL_VERSION = '2.4.0'

PerformHttpRequest('https://api.anticheat.ac/v1/version', function(status, body)
  if status ~= 200 then return end

  local data = json.decode(body)
  if data.version ~= LOCAL_VERSION then
    print(('[Ocean] Version %s is available (running %s)'):format(data.version, LOCAL_VERSION))
  end
end, 'GET')