Перейти к основному содержимому

API версии

GET /v1/version

API версии показывает текущую активную версию клиента Ocean. На этот эндпоинт стоит направить проверку версии, когда серверу, боту или конвейеру развёртывания нужно знать, запущена ли последняя сборка.

API-ключ не нужен

Это единственный эндпоинт /v1, который полностью публичен. Активная версия — не секретная информация, поэтому проверке версии не нужны ни учётные данные, ни лицензия, ни API-ключ.

Базовый URL
https://api.anticheat.ac/v1
Аутентификация
Нет
Лимит запросов
60 запросов в минуту на IP

Получить текущую версию

Возвращает версию, которая сейчас помечена как активная, вместе с примечаниями к выпуску и датой выпуска.

GET/v1/version

Ответ

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

Поля ответа

ПолеТипОписание
versionstringСтрока версии, которая сейчас активна
releaseNotesstringПримечания к выпуску активной версии. Пустая строка, если их не публиковали
releasedAtstringМетка времени ISO 8601 создания версии

Ошибки

СтатусЗначение
404Сейчас нет версии, помеченной как активная
429Превышен лимит запросов для вашего IP-адреса

Кэширование

Ответ кэшируется на сервере на 60 секунд. При опросе чаще раза в минуту возвращается тот же ответ без обращения к базе данных, поэтому проверки раз в несколько минут более чем достаточно, чтобы быстро заметить новый выпуск.

Пример использования

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