# API

**API Ocean** REST API для данных проверок, сведений о пользователях, оценок риска и систем обнаружения. Для авторизованных вызовов действует лимит 1 000 запросов в час.

HTML version: https://anticheat.ac/ru/docs/api

## Требования

Для API нужна активная лицензия или членство в Enterprise. Бесплатные пользователи не могут создавать ключи API. Единственное исключение — /v1/version, он публичный.

- **Базовый URL**: https://api.anticheat.ac/v1
- **Аутентификация**: заголовок x-api-key
- **Лимит запросов**: 1 000 запросов/час
- **Метка сервера**: Необязательный заголовок x-server-name

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

Каждый авторизованный вызов записывается — префикс ключа, эндпоинт, IP и имя сервера — и хранится 90 дней для выявления передачи ключей и злоупотреблений. Полные ключи не сохраняются.

## Эндпоинты

- [Проверенные пользователи](https://anticheat.ac/ru/docs/api/scanned-users): Полная история проверок, детекты, статус бана/предупреждений и связанные аккаунты пользователя Discord.
- [Оценка риска пользователя](https://anticheat.ac/ru/docs/api/user-risk-score): Сводная оценка и уровень риска по всем связанным профилям.
- [Результаты PIN](https://anticheat.ac/ru/docs/api/pins): Полные результаты проверок для PIN вашего аккаунта.
- [Статус PIN](https://anticheat.ac/ru/docs/api/pin-status): Ход проверки в реальном времени, процент выполнения и сводка результатов.
- [Создание PIN](https://anticheat.ac/ru/docs/api/pins-create): Программное создание PIN для проверок. Только для владельцев Enterprise.
- [База читеров](https://anticheat.ac/ru/docs/api/database): Профиль сообщества, поиск по сети и совпадения проверок Ocean по Discord ID. Нужен DB Access.
- [Версия](https://anticheat.ac/ru/docs/api/version): Текущая активная версия клиента Ocean. Публичный, ключ не нужен.
- [MCP-сервер](https://anticheat.ac/ru/docs/api/mcp): Удалённый MCP-сервер, предоставляющий ИИ-агентам те же данные, что и REST API, по Streamable HTTP. OAuth 2.1 с PKCE — без ключа API.

## Уровни риска

| Уровень | Оценка | Значение |
| --- | --- | --- |
| clean | 0 | Нет детектов и подозрительной активности |
| low | 1–25 | Незначительные флаги, скорее всего ложные срабатывания |
| medium | 26–50 | Обнаружена подозрительная активность |
| high | 51–75 | Несколько детектов, вероятно читы |
| critical | 76–100 | Подтверждённые читы с обширной историей |

## Documentation pages

- [API](https://anticheat.ac/ru/docs/api)
- [Проверенные пользователи](https://anticheat.ac/ru/docs/api/scanned-users)
- [Оценка риска пользователя](https://anticheat.ac/ru/docs/api/user-risk-score)
- [PIN-коды](https://anticheat.ac/ru/docs/api/pins)
- [Статус PIN](https://anticheat.ac/ru/docs/api/pin-status)
- [Создание PIN](https://anticheat.ac/ru/docs/api/pins-create)
- [База читеров](https://anticheat.ac/ru/docs/api/database)
- [Версия](https://anticheat.ac/ru/docs/api/version)
- [MCP](https://anticheat.ac/ru/docs/api/mcp)

## Markdown pages

- [Ocean Anti-Cheat](https://anticheat.ac/md/ru)
- [Цены](https://anticheat.ac/md/ru/pricing)
- [Скачать](https://anticheat.ac/md/ru/downloads)
- [Документация](https://anticheat.ac/md/ru/docs)
- [Детекты](https://anticheat.ac/md/ru/docs/detections)
- [Full reference for language models](https://anticheat.ac/llms-full.txt)