MANAGE_BOTS + verified_bot Kuralı
Bir sunucuya bot ekleyebilmek için MANAGE_BOTS iznin olmalı ve bot ya kendi botun ya da admin onaylı verified_bot rozetine sahip olmalıdır; aksi halde 403 bot_not_allowed döner.
Botlar normal kullanıcılarla aynı REST API’yi ve Socket.IO /gateway bağlantısını kullanır. Kullanıcı başına en fazla 5 bot oluştur ve Authorization: Bot <token> ile bağlan.
5 Bot
Kullanıcı Başına Kota
POST /api/bots ile anında oluştur ve yönet
Authorization: Bot
REST Kimlik Başlığı
SHA-256 özetiyle doğrulanan tek seferlik token
/gateway
Socket.IO Akış Yolu
Otomatik yeniden bağlanma ve canlı önbellek
27 İzin
Bitfield Yetki Sistemi
computePermissions ile istemci ve sunucu uyumu
mercys.js SDK · 0.2
Tek runtime bağımlılığı socket.io-client olan mercys.js ile olay dinleyicileri, komut yardımcıları ve izin kontrolleri yaz.
npm install mercys.jsimport { Client } from 'mercys.js';
const client = new Client({
token: process.env.MERCYS_TOKEN!,
baseUrl: 'http://localhost:4100',
});
client.on('ready', (me) => {
console.log(`${me.username} olarak giriş yapıldı`);
});
client.on('messageCreate', async (msg) => {
if (msg.author.isBot) return;
if (msg.content === '!ping') {
await msg.reply('pong');
}
});
await client.login();REST & Gateway Özeti
Bot yönetim uçları yalnızca kullanıcı JWT’si (Bearer) ile çalışır; bot token’ı ile çağrıldığında 403 bots_forbidden döner.
| GET | /api/bots | Kullanıcının sahip olduğu tüm botları listeler (Bot[]). |
| POST | /api/bots | Yeni bot oluşturur (201, BotWithToken; en fazla 5 bot). |
| POST | /api/bots/:id/token | Token’ı sıfırlar; eski token ve açık oturumlar anında düşer. |
| DELETE | /api/bots/:id | Botu, mesajlarını ve sahip olduğu sunucuları kalıcı olarak siler (204). |
| POST | /api/servers/:id/bots | { botId } ile sunucuya bot ekler (MANAGE_BOTS + bot kuralı). |
| ready | ready / resumed | SelfUser ve başlangıç önbelleği (servers, voiceStates) |
| message:create | messageCreate | Message nesnesi (msg.reply, msg.edit, msg.delete yardımcılarıyla) |
| message:update / delete | messageUpdate / messageDelete | Güncellenen Message veya { id, channelId, serverId } |
| member:join | memberJoin | Sunucuya yeni katılan Member (bot eklendiğinde tüm üyeler alır) |
| server:create | serverCreate | Bot yeni bir sunucuya eklendiğinde ServerListEntry ile tetiklenir |
| voice:state | voiceState | VoiceParticipantState (kanal, mute, kamera ve yayın durumu) |
Güvenlik & Yetkilendirme Kuralları
Bir sunucuya bot ekleyebilmek için MANAGE_BOTS iznin olmalı ve bot ya kendi botun ya da admin onaylı verified_bot rozetine sahip olmalıdır; aksi halde 403 bot_not_allowed döner.
Token biçimi <botId>.<32 bayt base64url> şeklindedir. Sunucu yalnızca SHA-256 özetini saklar; sızıntıda POST /api/bots/:id/token eski oturumları anında kapatır.
Bot sunucuya yalnızca @everyone rolüyle katılır. ADMINISTRATOR vermek yerine yalnızca ihtiyaç duyduğu izin bitlerini tanımla.
Web uygulamasından hesabına giriş yap, token’ını ortam değişkenine ekle ve mercys.js ile ilk komutunu çalıştır.