Resmi Discord API'si, botlar ve istemciler için yapılmış düşük seviyeli bir yüzeydir; gateway olaylarıyla konuşur, önbelleği elle yönetir ve intent'leri dengelersin. Noxyr Sunucu API'si ise tek bir sunucuya kapsamlı, hazır analizler döndüren üst seviye bir HTTP API'sidir. İkisi farklı sorunları çözer. Her birine ne zaman uzanacağın aşağıda.
Discord API sana neler verir?
Discord API dokümantasyonu (çok aranıyor; Google Trends, "discord api documentation" sorgularının yıllık bazda %700 arttığını gösteriyor), Discord'un kendisine ait her şey için tek doğru kaynaktır: mesajlar, kullanıcılar, sunucular, roller, kanallar, ses, thread'ler, moderasyon. Eylemler için bir REST API, olaylar için bir WebSocket gateway'i alırsın. Gerçek zamanlı herhangi bir şey inşa etmek, kalıcı bir bağlantı açmayı, READY ve heartbeat'leri, önbellek geçersiz kılmalarını ve hız sınırı kovalarını yönetmeyi gerektirir.
Noxyr Sunucu API'si sana neler verir?
Noxyr Sunucu API'si çok daha küçük bir yüzeydir: bir taşıyıcı (bearer) token ile tek bir sunucuya kapsamlı, yalnızca okunabilir altı uç nokta. Veri Discord'da değil Noxyr veritabanında durduğu için, Discord API'sinin hiç yanıtlayamayacağı "bu ay kaç bilet var?" ya da "para birimi başına gelir ne?" gibi soruları yanıtlar.
Yan yana karşılaştırma
- Kimlik doğrulama: Discord, intent'lerle birlikte OAuth2 ya da bot tokenları kullanır. Noxyr sunucu başına tek bir taşıyıcı token kullanır.
- Taşıma: Discord, REST + WebSocket gateway'dir. Noxyr, tarayıcılar için CORS etkin düz HTTPS'tir.
- Kapsam: Discord, botunun bulunduğu her sunucuda geneldir. Noxyr, belirli tek bir sunucuya bağlıdır.
- Veri şekli: Discord ham nesneler döndürür: sunucular, üyeler, mesajlar. Noxyr toplamlar, ortalamalar ve günlük gruplamalar döndürür.
- Hız sınırları: Discord, uç nokta başına kovalı sınırlar kullanır. Noxyr anahtar başına sabit 60 istek/dakikadır.
- Kurulum çabası: Discord bir bot uygulaması, davet, intent'ler ve olay işleyicileri ister. Noxyr bir anahtar üretmek için tek tıklama ister.
Discord'u ne zaman seçmelisin?
- Gerçek zamanlı olaylara ihtiyacın varsa (bir mesaj geldi, bir üye katıldı, bir ses kanalı değişti).
- Uygulamandan mesaj göndermek, kanalları düzenlemek, kullanıcıları banlamak ya da rolleri yönetmek istiyorsan.
- Bir Discord botu ya da üçüncü taraf bir Discord istemcisi geliştiriyorsan.
Noxyr Sunucu API'sini ne zaman seçmelisin?
- Bir bot bakımı yapmadan, herkese açık bir web sitesinde canlı sunucu istatistiklerini göstermek istiyorsan.
- Discord'un saklamadığı veriler olan bilet analizlerine, satış verilerine, değerlendirme ortalamalarına ya da çekiliş katılımına ihtiyacın varsa.
- Bir tarayıcı panelinden proxy olmadan çağırabileceğin, CORS dostu JSON istiyorsan.
- Kapsam anahtarlarıyla hiçbir şeyi yeniden dağıtmadan veri açığa çıkarmayı kapatabileceğin, sürümlü ve istikrarlı bir yüzey istiyorsan.
İkisini birlikte kullanmak
İki API iyi eşleşir. Kendi botunda olaylara tepki vermek için Discord API'sini, web sitendeki toplu durumu okumak için Noxyr Sunucu API'sini kullan. Böylece herkese açık panelin bot intent'lerine ya da gateway bağlantılarına hiç ihtiyaç duymaz; tek bir HTTPS isteği yeter.
Daha fazlası: Sunucu API eğitimi, tasarım ilkeleri, Discord API hatalarıyla başa çıkmak.