Obter Informações do Bot
Este endpoint retorna todas as informações públicas e detalhadas de um bot específico cadastrado no BotGate.
Endpoint
GET | /api/v1/bots/:botId | Não |
|---|
URL Completa:
https://botgate-api-987684559046.us-central1.run.app/api/v1/bots/:botId
Pública
Este endpoint não requer chave de API (Bearer Token), pois retorna apenas informações públicas que já estão disponíveis no site.
Parâmetros de URL
| Parâmetro | Tipo | Descrição |
|---|---|---|
botId | String | O ID do bot no Discord. |
Resposta de Sucesso (Completa)
{
"success": true,
"data": {
"id": "1234567890123456789",
"name": "BotTeste",
"avatar": "cd14054607269a5862eade995a0d8ba3",
"discriminator": "8563",
"shortDescription": "Uma breve descrição do meu bot!",
"longDescription": "Descrição detalhadamente do meu bot, com todas as funcionalidades dele e como ele funciona na prática, dentro do Discord!",
"tagline": "Uma breve descrição do meu bot!",
"prefix": "/",
"inviteUrl": "https://discord.com/oauth2/authorize?client_id=1234567890123456789&scope=bot&permissions=8",
"supportServer": "https://www.discord.gg/botteste",
"website": "https://bot-teste-.com/",
"github": "https://github.com/dono-teste/bot-teste",
"social": {
"twitter": "https://www.x.com/botteste",
"instagram": "https://www.instagram.com/bot_teste",
"youtube": "https://www.youtube.com/@botteste"
},
"verified": false,
"premium": false,
"certified": false,
"status": "approved",
"stats": {
"servers": 4,
"users": "273",
"shards": 1,
"rating": 0,
"reviews": 0,
"lastStatsUpdate": "2026-01-24T04:17:06.000Z"
},
"owner": {
"id": "1234567890123456789",
"username": "donoteste",
"avatar": "a_52d7e9c6b5ab20c6f729f51362f571bb",
"discriminator": "0"
},
"categories": [ ... ],
"features": [ ... ],
"languages": [ ... ],
"tags": [ ... ],
"commands": [ ... ],
"createdAt": "2026-01-24T03:13:57.000Z",
"updatedAt": "2026-01-24T07:19:25.000Z",
"approvedAt": "2026-01-24T03:22:49.000Z",
"lastBump": null
}
}
Casos de Uso
- Páginas de Status: Mostrar as estatísticas reais do seu bot no seu próprio site.
- Dashboards Externos: Integrar informações do BotGate em ferramentas de terceiros.
- Validação: Verificar se o bot já foi aprovado e quais badges ele possui na plataforma.
Pacote NPM
Você pode obter essas informações programaticamente através do método reporter.getBotInfo().