Przejdź do głównej treści

API wersji

GET /v1/version

API wersji udostępnia aktualnie aktywną wersję klienta Ocean. To endpoint, do którego warto skierować sprawdzacz wersji, gdy serwer, bot lub pipeline wdrożeniowy ma wiedzieć, czy działa na najnowszym buildzie.

Klucz API nie jest wymagany

To jedyny w pełni publiczny endpoint /v1. Aktywna wersja nie jest informacją wrażliwą, więc sprawdzacz wersji nie potrzebuje danych logowania, licencji ani klucza API, aby ją odczytać.

Bazowy URL
https://api.anticheat.ac/v1
Uwierzytelnianie
Brak
Limit żądań
60 żądań na minutę na IP

Pobierz aktualną wersję

Zwraca wersję oznaczoną obecnie jako aktywna wraz z notatkami wydania i datą wydania.

GET/v1/version

Odpowiedź

{
  "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"
}

Pola odpowiedzi

PoleTypOpis
versionstringCiąg wersji, który jest obecnie aktywny
releaseNotesstringNotatki wydania aktywnej wersji. Pusty ciąg, gdy żadnych nie opublikowano
releasedAtstringZnacznik czasu ISO 8601 utworzenia wersji

Błędy

StatusZnaczenie
404Żadna wersja nie jest obecnie oznaczona jako aktywna
429Przekroczono limit żądań dla Twojego adresu IP

Cache

Odpowiedź jest cache'owana po stronie serwera przez 60 sekund. Odpytywanie częściej niż raz na minutę zwraca ten sam payload bez zapytania do bazy, więc sprawdzacz uruchamiany co kilka minut w zupełności wystarczy, by szybko wychwycić nowe wydanie.

Przykład użycia

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')