Pular para o conteúdo principal

API de versão

GET /v1/version

A API de versão expõe a versão do cliente do Ocean atualmente ativa. É o endpoint para onde apontar um verificador de versão quando você quer que um servidor, um bot ou um pipeline de deploy saiba se está rodando a build mais recente.

Não requer chave de API

Este é o único endpoint /v1 totalmente público. A versão ativa não é uma informação sensível, então um verificador de versão não precisa de credenciais, licença nem chave de API para lê-la.

URL base
https://api.anticheat.ac/v1
Autenticação
Nenhum
Limite de requisições
60 requisições por minuto por IP

Obter a versão atual

Retorna a versão atualmente marcada como ativa, junto com suas notas de versão e a data de lançamento.

GET/v1/version

Resposta

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

Campos da resposta

CampoTipoDescrição
versionstringA string de versão atualmente ativa
releaseNotesstringNotas de versão da versão ativa. String vazia quando nenhuma foi publicada
releasedAtstringTimestamp ISO 8601 de quando a versão foi criada

Erros

StatusSignificado
404Nenhuma versão está marcada como ativa no momento
429Limite de requisições excedido para o seu endereço IP

Cache

A resposta fica em cache no servidor por 60 segundos. Consultar mais de uma vez por minuto retorna o mesmo payload sem tocar no banco de dados, então um verificador que roda a cada poucos minutos é mais do que suficiente para detectar rapidamente um novo lançamento.

Exemplo de uso

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