İzinler

İzinler bir bit alanıdır. Her iznin bir biti vardır ve API değeri ondalık metin olarak taşır: "68672". Metin yerine sayı göndermek veya tanımlı olmayan bir bit kullanmak 400 invalid_body verir.

Değeri hesaplamak

Portaldaki Ekleme bağlantısı bölümünde izinleri seçtiğinde değer senin için hesaplanır ve bağlantıdaki izin olur.

Kendin hesaplamak istersen izinlerin değerlerini topla (veya bitlerini OR ile birleştir). Bazı izinler 32 bitin üstünde olduğu için JavaScript'te BigInt kullan:

const VIEW_CHANNEL = 1n << 10n;
const SEND_MESSAGES = 1n << 11n;
const value = VIEW_CHANNEL | SEND_MESSAGES;
console.log(value.toString()); // "3072"

Başlangıç rehberindeki 68608 şu toplamdır: ViewChannel (1024) + SendMessages (2048) + ReadMessageHistory (65536). Ses kanalına girip yayın yapan bir bot için 3146752 (ViewChannel + Connect + Speak) gerekir; ayrıntılar Ses sayfasında.

Ekleme bağlantısı bölümü Tepki ekle (AddReactions, 64) ve @herkes ve rolleri etiketle (MentionEveryone, 131072) izinlerini de sunar; bot bunları diğer izinler gibi isteyebilir.

İzin listesi

Bu aşamadaki bot rotalarının kullandığı izinler, REST referansında her rotanın altında yazar. Listedeki bazı izinlerin bu aşamada bota açık bir rotası yoktur.

Bir üyenin izinleri nasıl hesaplanır

Bot da diğer üyeler gibi hesaplanır.

Sunucu düzeyinde:

1. Sunucunun sahibi tüm izinlere sahiptir.
2. Diğer üyeler için @everyone rolünün izinleri ile üyenin tüm rollerinin izinleri birleştirilir.
3. Sonuçta Administrator varsa üye tüm izinlere sahiptir.

@everyone rolünün ID'si sunucunun ID'siyle aynıdır. Üyenin roles listesinde yer almaz, ama izinleri her zaman sayılır.

Bir rolün ID'sini sunucu ayarlarında Roller sekmesinden rolü açıp Kopyala ile alırsın (Android ve iOS'ta Rol ID'sini kopyala). Bir bot aynı kimlikleri GET /guilds/{id}/roles ile de listeleyebilir.

Kanalda. Administrator olanlar kanal ayarlarından etkilenmez. Diğerleri için kanalın izin geçersiz kılmaları (permission_overwrites) şu sırayla uygulanır; her adımda önce deny bitleri çıkarılır, sonra allow bitleri eklenir:

1. @everyone için olan geçersiz kılma
2. Üyenin rolleri için olanlar, birleştirilerek
3. Üyenin kendisi için olan

Bağımlı izinler. Kanalda ViewChannel yoksa hiçbir izin kalmaz. SendMessages yoksa SendTTSMessages, MentionEveryone, AttachFiles ve EmbedLinks de geçersiz olur. Connect yoksa Speak, Stream, MuteMembers, DeafenMembers, MoveMembers, UseVAD, PrioritySpeaker ve RequestToSpeak de geçersiz olur.

Susturma. Zamanlı susturma sürerken üyede yalnızca ViewChannel ve ReadMessageHistory kalır. Bu, susturulan bot için de geçerlidir. Sahip ve yöneticiler susturulamaz.

Bir izin geçersiz kılmasının türü (type) rol için 0, üye için 1'dir.

Rol sıralaması

Her rolün bir position değeri vardır, büyük olan daha üsttedir. Üyenin rütbesi, en yüksek rolünün konumudur. Sunucu sahibi herkesten üsttedir.

• Bir üyeyi çıkarmak, yasaklamak, susturmak veya takma adını değiştirmek için rütben hedefin rütbesinden büyük olmalıdır. Eşitlik yetmez; aksi halde 403 role_hierarchy döner.
• Bir rolü düzenlemek, silmek, vermek veya almak için rütben o rolün konumundan büyük olmalıdır.
• Rolün position değerini kendi rütbenden küçük bir değere ayarlayabilirsin; en küçük değer 1'dir.
• Sahip olmadığın bir izni kimseye veremezsin (403 missing_permissions). Kanal geçersiz kılmaları için de aynısı geçerlidir.

Botun için bunun anlamı: Bot sunucuya eklenince rolü doğrudan @everyone'ın üstüne konur. Bu haliyle yalnızca rolü olmayan üyeler üzerinde işlem yapabilir. Moderasyon yapacak botun rolünü, bir sunucu yöneticisi Sunucu ayarları içindeki Roller listesinde sürükleyerek işlem yapacağı rollerin üstüne taşımalıdır.

Bot kendi rolünü değiştiremez, çünkü rütbesi o rolün konumundan büyük değildir; daha yüksek bir rol verilmişse değiştirebilir.

Sık görülen durumlar

Bu sayfayı yapay zekaya verirsen

Sırada ne var

• Komut izinleri: komutların hangi rol ve kanalda çalışacağını yönetmek
• Uygulamalar ve botlar: /bot-ekle bağlantısı ve yönetilen bot rolü
• Sık hatalar: missing_access, missing_permissions ve role_hierarchy farkı