Documentação da API

Guia completo de integração para desenvolvedores.

Gerenciador de EBKEYS

Crie suas chaves para acessar a API V2.

Carregando chaves...

API Endpoints

Rate Limit (Limite de Uso):
Todas as requisições são limitadas a 10 requisições por segundo por IP.
Abusos resultarão no erro 429 Too Many Requests.

1. Consultar por Discord ID (V1)

Descubra a conta Roblox vinculada a um ID do Discord. (Público)

GET /api/check/<discord_id>
Exemplo de Retorno: { "status": "success", "linked": true, "data": { "roblox_id": "7422278444", "roblox_username": "Criador_Mirage" } }

2. Consultar por Roblox ID (V1)

Descubra a conta Discord vinculada a um ID do Roblox. (Público)

GET /api/reverse/<roblox_id>
Exemplo de Retorno: { "status": "success", "linked": true, "data": { "discord_id": "123456789012345678", "discord_username": "Mirage" } }

3. Perfil Discord (V1)

Retorna perfil completo buscando por ID do Discord. (Público)

GET /api/profile/discord/<query>
Exemplo de Retorno: { "found": true, "discord": { "id": "123456789012345678", "username": "Mirage" }, "roblox": { "id": "7422278444", "username": "Criador_Mirage", "display_name": "Admin", "avatar_url": "https://tr.rbxcdn.com/..." }, "account_created_at": "2026-01-05 14:30:00" }

4. Perfil Roblox (V1)

Retorna perfil completo buscando por ID ou Username do Roblox. (Público)

GET /api/profile/roblox/<query>
Exemplo de Retorno: { "found": true, "discord": { "id": "123456789012345678", "username": "Mirage" }, "roblox": { "id": "7422278444", "username": "Criador_Mirage", "display_name": "Admin", "avatar_url": "https://tr.rbxcdn.com/..." }, "account_created_at": "2026-01-05 14:30:00" }

API V2 (Strict Mode)

Endpoints otimizados que exigem autenticação obrigatória via Header X-EB-KEY.

5. Check Discord (V2)

Mesma função da V1, mas exige autenticação.

GET /api/v2/check/<discord_id>
Exemplo de Retorno: { "status": "success", "linked": true, "data": { "roblox_id": "7422278444", "roblox_username": "Criador_Mirage" } }

6. Check Reverso (V2)

Mesma função da V1, mas exige autenticação.

GET /api/v2/reverse/<roblox_id>
Exemplo de Retorno: { "status": "success", "linked": true, "data": { "discord_id": "123456789012345678", "discord_username": "Mirage" } }

7. Perfil Discord (V2)

Busca perfil completo por Discord ID. Exige autenticação.

GET /api/v2/profile/discord/<query>
Exemplo de Retorno: { "found": true, "discord": { "id": "123456789012345678", "username": "Mirage" }, "roblox": { "id": "7422278444", "username": "Criador_Mirage", "display_name": "Admin", "avatar_url": "https://tr.rbxcdn.com/..." }, "account_created_at": "2026-01-05 14:30:00" }

8. Perfil Roblox (V2)

Busca perfil completo por Roblox ID/User. Exige autenticação.

GET /api/v2/profile/roblox/<query>
Exemplo de Retorno: { "found": true, "discord": { "id": "123456789012345678", "username": "Mirage" }, "roblox": { "id": "7422278444", "username": "Criador_Mirage", "display_name": "Admin", "avatar_url": "https://tr.rbxcdn.com/..." }, "account_created_at": "2026-01-05 14:30:00" }

9. Perfil Unificado (V2)

Busca inteligente que detecta automaticamente o tipo de input.

GET /api/v2/profile/<query>
Exemplo de Retorno: { "found": true, "discord_id": "123456789012345678", "roblox": { "id": "7422278444", "username": "Criador_Mirage", "display": "Admin", "avatar": "https://tr.rbxcdn.com/..." } }

10. Batch Check (Em Massa)

Verifica até 100 IDs do Discord de uma única vez.

POST /api/v2/batch-check
Header: X-EB-KEY: sua_chave
Body (JSON): { "ids": ["123", "456", "789"] }
Exemplo de Retorno: { "total_sent": 3, "found_count": 2, "users": { "123": { "roblox_id": "7422278444", "nick": "Criador_Mirage" }, "456": { "roblox_id": "4719963080", "nick": "Admin_Mirage" } } }

Gerenciamento de Chaves

11. Criar Chave

Gera uma nova EBKEY vinculada a um Bot ID (Máx 2 por conta).

POST /api/keys/create
Body (JSON): { "bot_id": "123456789" }
Exemplo de Retorno: { "status": "created", "key": "ebdomirage|a1b2c3d4e5f6...", "bot_name": "Meu Bot Python" }

12. Deletar Chave

Revoga uma chave existente.

POST /api/keys/delete
Body (JSON): { "key": "ebdomirage|..." }
Exemplo de Retorno: { "status": "deleted" }

13. Listar Chaves

Retorna todas as suas chaves ativas.

GET /api/keys/list
Exemplo de Retorno: [ { "key": "ebdomirage|a1b2c3d4e5f6...", "owner_id": "123456789012345678", "bot_id": "1263086691174842429", "bot_name": "Meu Bot Python", "created_at": "2026-03-22 10:00:00" } ]

Códigos de Erro

Lista dos códigos HTTP que a API pode retornar.

CódigoSignificadoDescrição
200 OKSucessoA requisição foi processada corretamente.
400 Bad RequestRequisição InválidaFaltam parâmetros ou o JSON está mal formatado.
401 UnauthorizedNão AutorizadoA EBKEY não foi fornecida ou é inválida.
403 ForbiddenProibidoVocê não tem permissão para acessar este recurso ou atingiu o limite de chaves.
404 Not FoundNão EncontradoO usuário ou recurso não existe no banco de dados.
429 Too Many RequestsMuitas RequisiçõesVocê excedeu o limite de taxa (10 req/s).
500 Internal ErrorErro do ServidorErro interno. Contate o administrador.
Voltar para o Início