API REST

Saúde do backend (uptime, memória).

curl https://gbbot.com.br/api/health

{
  "status": "online",
  "bot": "GBBOT",
  "timestamp": "2026-05-20T15:30:00.000Z",
  "uptimeSeconds": 3600,
  "memory": { "heapUsedMB": 128, "heapTotalMB": 256, "rssMB": 320 }
}

Status agregado de bot + backend + site + lojas (cache 15s).

curl https://gbbot.com.br/api/public-status

{
  "bot":   { "ok": true, "status": "online", "guilds": 120, "uptime": "2d 4h" },
  "api":   { "ok": true, "version": "1.0.0" },
  "site":  { "ok": true },
  "lojas": { "ok": true, "published": 12 },
  "checkedAt": "2026-05-20T15:30:00.000Z"
}

Histórico de changelog público (cache 60s).

curl https://gbbot.com.br/api/updates

[
  {
    "_id": "abc",
    "version": "20-05-2026",
    "title": "Update 20/05",
    "content": "...",
    "imageUrl": "https://i.imgur.com/xxx.gif",
    "buttons": [{ "label": "...", "url": "..." }],
    "publishedAt": "2026-05-20T20:22:19.319Z"
  }
]

Lista de templates públicos do marketplace. Filtros opcionais.

curl 'https://gbbot.com.br/api/marketplace?sort=downloads&limit=10'

{
  "items": [
    {
      "slug": "setup-gaming-ptbr",
      "name": "Setup Gaming PT-BR",
      "description": "...",
      "authorName": "fernandodoprado",
      "icon": "gamepad2",
      "tags": ["gaming", "pt-br"],
      "downloads": 42,
      "featured": true,
      "createdAt": "..."
    }
  ],
  "total": 100,
  "page": 1,
  "limit": 10
}

Detalhe de um template (NÃO retorna config inteira; só metadados + seções).

curl https://gbbot.com.br/api/marketplace/setup-gaming-ptbr

Inscreve email na newsletter. Rate limit: 1/IP/min.

curl -X POST https://gbbot.com.br/api/newsletter/subscribe \
  -H 'Content-Type: application/json' \
  -d '{"email":"voce@exemplo.com","source":"footer"}'

{ "ok": true, "status": "subscribed" }

Remove email (sem auth — apenas conhecimento do email basta).

curl -X POST https://gbbot.com.br/api/newsletter/unsubscribe \
  -H 'Content-Type: application/json' \
  -d '{"email":"voce@exemplo.com"}'

Contagem pública de inscritos ativos.

curl https://gbbot.com.br/api/newsletter/count

{ "count": 1234 }

User logado (perfil Discord, premium, owned guilds).

curl --cookie 'token=SEU_JWT' https://gbbot.com.br/api/auth/me

Lista de guildas que o user administra (com licenseInfo).

curl --cookie 'token=SEU_JWT' https://gbbot.com.br/api/guilds

Config completa de uma guilda (sem panelAccess.encryptedPassword).

Lista de canais da guilda (text + announcement + voice).

Lista de cargos da guilda (com hierarquia/posição).

Baixa JSON da config inteira (whitelist segura — sem panelAccess/premium).

curl -L --cookie 'token=SEU_JWT' \
  -o config.json \
  https://gbbot.com.br/api/guilds/SEUID/export-config

Aplica um JSON na config. Whitelist de seções permitidas.

curl -X POST --cookie 'token=SEU_JWT' \
  -H 'Content-Type: application/json' \
  --data @config.json \
  https://gbbot.com.br/api/guilds/SEUID/import-config

Aplica um template pré-configurado.

curl -X POST --cookie 'token=SEU_JWT' \
  -H 'Content-Type: application/json' \
  -d '{"templateId":"gaming"}' \
  https://gbbot.com.br/api/guilds/SEUID/apply-template

Lista templates de Quick Setup disponíveis.

Log de auditoria da guilda (TTL 180d).

Lista webhooks configurados (sem expor secret).

Cria webhook. **Retorna o secret APENAS aqui** — guarde imediatamente.

curl -X POST --cookie 'token=SEU_JWT' \
  -H 'Content-Type: application/json' \
  -d '{
    "url": "https://meu-receiver.com/hook",
    "label": "Meu n8n",
    "events": ["raid.detected", "ticket.created"]
  }' \
  https://gbbot.com.br/api/guilds/SEUID/webhooks

{
  "ok": true,
  "id": "...",
  "secret": "abc123def456...",
  "warning": "Anote agora — não mostramos de novo"
}

Publica config da sua guilda como template público. Rate limit: 5min/user.

curl -X POST --cookie 'token=SEU_JWT' \
  -H 'Content-Type: application/json' \
  -d '{
    "guildId": "SEUID",
    "name": "Meu Setup",
    "description": "Descrição com pelo menos 20 caracteres",
    "tags": ["pt-br", "small"],
    "icon": "star"
  }' \
  https://gbbot.com.br/api/marketplace/publish

Aplica template do marketplace no seu servidor.

Seu código de afiliado + link + stats de conversões.

Valida código de afiliado antes do checkout.

curl -X POST --cookie 'token=SEU_JWT' \
  -H 'Content-Type: application/json' \
  -d '{"code":"ABCD1234"}' \
  https://gbbot.com.br/api/me/referral/validate

Bot encaminha reporte de /bug pra persistência.

Bot dispara evento de webhook (não tem o model GuildWebhook, chama backend).

Bot cria pedido na loja virtual (Discord-side checkout flow).

Lista eventos (todos os status).

Cria evento. Body: { title, description, startAt, durationMins, channelId, maxParticipants, xpReward }.

Edita evento. Re-publica embed no Discord.

Cancela evento (soft-delete, status=cancelled).

Lista sugestões + stats por status.

Atualiza status (pending/in_progress/approved/rejected) ou adminResponse.

Remove sugestão do dashboard (não some do Discord).

Lista itens da loja (config admin).

Cria item. Body: { roleId, name, priceXp, durationDays, maxStock, purchaseLimit }.

Histórico de compras (últimas 100).

Configura: enabled, channelId, thresholds[], message, cardBackgroundUrl.

Reseta announced[] pra re-anunciar marcos atingidos.

Lê config (channelId, message, cardEnabled, cardBackgroundUrl).

Atualiza config.

Lista aniversariantes ordenados por proximidade.

Info do bot dedicado atribuído (applicationId, status, customConfig).

Atualiza nome/desc/avatar/banner/cor. Sync aplica em até 30 min via Discord REST.

Pergunta pro assistente. Body: { messages: [{role:"user", content:"..."}] }. Rate limit: 100/h + 50/dia por user.