API Ocean

Ocean предоставляет RESTful API для программного доступа к данным сканирования, информации о пользователях, оценкам риска и системам обнаружения. Все эндпоинты используют API-ключи для аутентификации и ограничены 1 000 запросов в час.

Требования

API Ocean доступен только пользователям с активной лицензией или членством в Enterprise. Бесплатные пользователи не могут создавать и использовать API-ключи.

Единственное исключение — /v1/version, он публичный и не требует API-ключа.

Базовый URL: https://api.anticheat.ac/v1
Аутентификация: Передавайте API-ключ в заголовке x-api-key
Необязательно: Отправляйте x-server-name чтобы пометить, какой из ваших серверов сделал вызов

Доступные эндпоинты

GET/v1/scanned-users/lookup/:discordIdЗапрос полной истории сканирований, детектов, статуса бана и предупреждений и связанных аккаунтов пользователя DiscordРазрешение: scanned-users:lookupGET/v1/users/:discordId/risk-scoreПолучение рассчитанной оценки и уровня риска пользователя DiscordРазрешение: user:risk-scoreGET/v1/pins/:pinCode/resultsПрограммно получайте результаты сканирования для своих PINРазрешение: pins:resultsGET/v1/pins/:pinCode/statusПолучение хода сканирования в реальном времени, процента статуса и сводки результатов по вашим PINРазрешение: pins:statusPOST/v1/pins/createПрограммно создавайте PIN-коды сканирования через API. Только для владельцев Enterprise.Разрешение: pins:create(владелец Enterprise)GET/v1/db/query/:discordIdПоиск в базе читеров по Discord ID: профиль сообщества, сетевой поиск и совпадения сканирований OceanРазрешение: db:query(доступ к БД)GET/v1/versionПолучите текущую активную версию клиента Ocean. Подходит для проверки версииРазрешение: нет, этот эндпоинт публичный MCPhttps://api.anticheat.ac/mcpУдалённый MCP-сервер, предоставляющий ИИ-агентам те же данные, что и REST API, через Streamable HTTPАутентификация: OAuth 2.1

Журнал использования

Каждый аутентифицированный вызов API фиксируется: какой ключ использован, к какому эндпоинту обращались, IP вызывающего и необязательный заголовок x-server-name . Журналы хранятся 90 дней и служат для выявления передачи ключей и злоупотреблений. Они никогда не содержат ключ целиком, только его первые 12 символов.

Если один ключ обслуживает несколько серверов, отправляйте разный x-server-name с каждого из них. Так быстрее всего понять, какой сервер сделал вызов.

Ограничение запросов

Все эндпоинты API имеют общий глобальный лимит 1 000 запросов в час на API-ключ. Заголовки лимита (X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset) передаются в каждом ответе.