# API

**API da Ocean** Uma API RESTful para dados de scans, informações de usuários, pontuações de risco e sistemas de detecção. As chamadas autenticadas têm limite de 1.000 requisições por hora.

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

## Requisitos

A API exige uma licença ativa ou uma assinatura Enterprise. Usuários gratuitos não podem criar chaves de API. A única exceção é /v1/version, que é público.

- **URL base**: https://api.anticheat.ac/v1
- **Autenticação**: Cabeçalho x-api-key
- **Limite de requisições**: 1.000 requisições/hora
- **Nome do servidor**: Cabeçalho x-server-name opcional

## Registro de uso

Toda chamada autenticada é registrada — prefixo da chave, endpoint, IP e nome do servidor — e mantida por 90 dias para identificar compartilhamento de chaves e abusos. As chaves completas nunca são armazenadas.

## Endpoints

- [Usuários escaneados](https://anticheat.ac/pt/docs/api/scanned-users): Histórico completo de scans, detecções, status de banimento/aviso e contas relacionadas de um usuário do Discord.
- [Pontuação de risco do usuário](https://anticheat.ac/pt/docs/api/user-risk-score): Pontuação de risco agregada e nível em todos os perfis vinculados.
- [Resultados do PIN](https://anticheat.ac/pt/docs/api/pins): Resultados completos de scans dos PINs que pertencem à sua conta.
- [Status do PIN](https://anticheat.ac/pt/docs/api/pin-status): Progresso do scan em tempo real, porcentagem de status e resumo do resultado.
- [Criar PINs](https://anticheat.ac/pt/docs/api/pins-create): Crie PINs de scan por código. Apenas donos de Enterprise.
- [Banco de dados de cheaters](https://anticheat.ac/pt/docs/api/database): Perfil da comunidade, consulta na rede e correspondências de scans da Ocean por ID do Discord. Requer o DB Access.
- [Versão](https://anticheat.ac/pt/docs/api/version): A versão do cliente Ocean atualmente ativa. Público, sem necessidade de chave.
- [Servidor MCP](https://anticheat.ac/pt/docs/api/mcp): Servidor MCP remoto que expõe aos agentes de IA os mesmos dados da API REST por Streamable HTTP. OAuth 2.1 com PKCE — sem chave de API.

## Níveis de risco

| Nível | Pontuação | Significado |
| --- | --- | --- |
| limpo | 0 | Nenhuma detecção ou atividade suspeita |
| baixo | 1–25 | Sinalizações leves, provavelmente falsos positivos |
| médio | 26–50 | Alguma atividade suspeita detectada |
| alto | 51–75 | Várias detecções, provável cheat |
| crítico | 76–100 | Cheat confirmado com amplo histórico |

## Documentation pages

- [API](https://anticheat.ac/pt/docs/api)
- [Usuários escaneados](https://anticheat.ac/pt/docs/api/scanned-users)
- [Pontuação de risco do usuário](https://anticheat.ac/pt/docs/api/user-risk-score)
- [PINs](https://anticheat.ac/pt/docs/api/pins)
- [Status do PIN](https://anticheat.ac/pt/docs/api/pin-status)
- [Criar PINs](https://anticheat.ac/pt/docs/api/pins-create)
- [Banco de dados de cheaters](https://anticheat.ac/pt/docs/api/database)
- [Versão](https://anticheat.ac/pt/docs/api/version)
- [MCP](https://anticheat.ac/pt/docs/api/mcp)

## Markdown pages

- [Ocean Anti-Cheat](https://anticheat.ac/md/pt)
- [Preços](https://anticheat.ac/md/pt/pricing)
- [Download](https://anticheat.ac/md/pt/downloads)
- [Documentação](https://anticheat.ac/md/pt/docs)
- [Detecções](https://anticheat.ac/md/pt/docs/detections)
- [Full reference for language models](https://anticheat.ac/llms-full.txt)
