Endpoints de Bots

Aqui estão documentadas todas as rotas relacionadas a ações com bots individuais, como visualizar detalhes de um bot (GET /bots/:id) e atualizar o status de servidores do bot (POST /bots/status). Essa

🔍 GET /bots/:id

Retorna as informações de um bot específico.

Exemplo:

GET /bots/1234567890

Resposta:

{
  "_id": "1234567890",
  "name": "CoolBot",
  "description": "Um bot incrível!",
  "avatar": "https://cdn.discord.com/...",
  ...
}

---

POST /bots/status

Atualiza a contagem de servidores do bot autenticado por meio do Authorization header.

---

🔐 Requisitos de Autenticação:

• Header Authorization com a API Key do bot.

---

📥 Corpo da Requisição (JSON):

{
  "servers": 125
}

Campo	Tipo	Obrigatório	Descrição
servers	number	Sim	Número atual de servidores do bot.

---

📤 Exemplo de Requisição:

POST /bots/status HTTP/1.1
Host: localhost:3000
Authorization: YOUR_BOT_API_KEY
Content-Type: application/json

{
  "servers": 321
}

---

✅ Resposta de Sucesso (200):

{
  "_id": "123456789012345678",
  "owner": "098765432109876543",
  "name": "ExampleBot",
  "description": "Bot para testes",
  "longDescription": "Bot que faz coisas incríveis!",
  "avatar": "https://cdn.discordapp.com/avatars/.../avatar.webp",
  "servers": 321,
  "votes": 0,
  "verified": false,
  "createdAt": "2024-01-01T00:00:00.000Z",
  "updatedAt": "2025-03-10T14:00:00.000Z",
  "apiKey": "REDACTED"
}

---

⚠️ Códigos de Erro:

Código	Mensagem	Causa
401	No API key provided	Header Authorization ausente.
404	Bot not found	Nenhum bot encontrado com a API Key fornecida.
400	Field 'servers' must be a number	Campo servers ausente ou com tipo inválido.
500	Error while fetching/saving bot	Erro interno durante busca ou salvamento no banco.

---

🔎 Página 3: Busca e Listagem de Bots

🔍 GET /bots

Lista os bots com filtros opcionais.

Parâmetros:

• filter: "votes" | "new" | "used"

• limit: number

Exemplo:

GET /bots?filter=votes&limit=5