# API

**API Ocean** API RESTful do danych skanowania, informacji o użytkownikach, wyników ryzyka i systemów detekcji. Uwierzytelnione wywołania mają limit 1 000 żądań na godzinę.

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

## Wymagania

API wymaga aktywnej licencji lub członkostwa Enterprise. Darmowi użytkownicy nie mogą tworzyć kluczy API. Jedynym wyjątkiem jest /v1/version, które jest publiczne.

- **Bazowy URL**: https://api.anticheat.ac/v1
- **Uwierzytelnianie**: nagłówek x-api-key
- **Limit żądań**: 1 000 żądań/godz.
- **Etykieta serwera**: Opcjonalny nagłówek x-server-name

## Logowanie użycia

Każde uwierzytelnione wywołanie jest rejestrowane — prefiks klucza, punkt końcowy, IP i nazwa serwera — i przechowywane przez 90 dni, aby wykrywać udostępnianie kluczy i nadużycia. Pełne klucze nigdy nie są przechowywane.

## Punkty końcowe

- [Przeskanowani użytkownicy](https://anticheat.ac/pl/docs/api/scanned-users): Pełna historia skanowań, detekcje, status bana/ostrzeżenia i powiązane konta dla użytkownika Discord.
- [Wynik ryzyka użytkownika](https://anticheat.ac/pl/docs/api/user-risk-score): Zagregowany wynik i poziom ryzyka we wszystkich powiązanych profilach.
- [Wyniki PIN](https://anticheat.ac/pl/docs/api/pins): Pełne wyniki skanowania dla PIN-ów należących do Twojego konta.
- [Status PIN](https://anticheat.ac/pl/docs/api/pin-status): Postęp skanowania w czasie rzeczywistym, procent statusu i podsumowanie wyników.
- [Tworzenie PIN-ów](https://anticheat.ac/pl/docs/api/pins-create): Programowe tworzenie PIN-ów skanowania. Tylko właściciele Enterprise.
- [Baza cheaterów](https://anticheat.ac/pl/docs/api/database): Profil społeczności, wyszukiwanie w sieci i dopasowania skanowań Ocean według ID Discord. Wymaga DB Access.
- [Wersja](https://anticheat.ac/pl/docs/api/version): Aktualnie aktywna wersja klienta Ocean. Publiczne, klucz niepotrzebny.
- [Serwer MCP](https://anticheat.ac/pl/docs/api/mcp): Zdalny serwer MCP udostępniający agentom AI te same dane co REST API przez Streamable HTTP. OAuth 2.1 z PKCE — bez klucza API.

## Poziomy ryzyka

| Poziom | Wynik | Znaczenie |
| --- | --- | --- |
| clean | 0 | Brak detekcji lub podejrzanej aktywności |
| low | 1–25 | Drobne flagi, prawdopodobnie fałszywe alarmy |
| medium | 26–50 | Wykryto pewną podejrzaną aktywność |
| high | 51–75 | Wiele detekcji, prawdopodobne cheatowanie |
| critical | 76–100 | Potwierdzone cheatowanie z obszerną historią |

## Documentation pages

- [API](https://anticheat.ac/pl/docs/api)
- [Przeskanowani użytkownicy](https://anticheat.ac/pl/docs/api/scanned-users)
- [Wynik ryzyka użytkownika](https://anticheat.ac/pl/docs/api/user-risk-score)
- [PIN-y](https://anticheat.ac/pl/docs/api/pins)
- [Status PIN-u](https://anticheat.ac/pl/docs/api/pin-status)
- [Tworzenie PIN-ów](https://anticheat.ac/pl/docs/api/pins-create)
- [Baza oszustów](https://anticheat.ac/pl/docs/api/database)
- [Wersja](https://anticheat.ac/pl/docs/api/version)
- [MCP](https://anticheat.ac/pl/docs/api/mcp)

## Markdown pages

- [Ocean Anti-Cheat](https://anticheat.ac/md/pl)
- [Cennik](https://anticheat.ac/md/pl/pricing)
- [Pobierz](https://anticheat.ac/md/pl/downloads)
- [Dokumentacja](https://anticheat.ac/md/pl/docs)
- [Wykrycia](https://anticheat.ac/md/pl/docs/detections)
- [Full reference for language models](https://anticheat.ac/llms-full.txt)