Noxyr artık ücretsiz, sunucu bazlı bir REST API ile geliyor. Böylece canlı Discord verilerini, yani üye sayılarını, bilet analizlerini, etkinlik metriklerini, satışları, değerlendirmeleri ve çekilişleri web sitene, panelene, mobil uygulamana veya başka bir bota çekebilirsin. Her sunucu için bir anahtar var. Anahtar panelden üretilir, SHA-256 karma ile korunur ve sen kontrol ettiğin kapsam anahtarlarıyla sınırlandırılır.
Neden sunucuya özel bir API?
Çoğu Discord botu ya hiç veri sunmaz ya da seni intentler, gateway bağlantıları ve hız sınırı hesaplamalarıyla ham Discord API'si üzerinde uğraşmaya zorlar. Noxyr Sunucu API'si tam tersidir: bir başlık gönder, JSON al. Altı uç nokta, sunucu sahiplerinin gerçekten sorduğu soruları kapsar: Kaç üye var, bu hafta kaç bilet açıldı, para birimine göre gelir ne, ortalama değerlendirme puanı kaç, hangi çekilişler çalışıyor, günlük etkinlik trendi nasıl.
Bugün neleri okuyabilirsin
GET /api/v1/server: sunucu adı, simge URL'si, canlı üye sayısı, çevrimiçi sayısı, boost'lar, oluşturulma tarihi.GET /api/v1/tickets: toplam / açık / kapalı, son 7 ve 30 günde açılan biletler, son 7 günde kapanan biletler, ortalama puan ve puan sayısı.GET /api/v1/activity?days=30: 90 güne kadar günlük mesajlar, katılımlar ve ayrılmalar. Her tarih yer alsın diye boş günler sıfırla doldurulur.GET /api/v1/invoices: fatura sayıları, 7 ve 30 günlük hacim, para birimine göre gelir ve ödeme durumu dağılımı.GET /api/v1/reviews: toplam yazılmış değerlendirme, ortalama puan, 1–5 yıldız dağılımı ve en son 5 değerlendirme (ürün, puan, kısa metin, yazar).GET /api/v1/giveaways: aktif / bitmiş sayıları, toplam katılım ve bitmek üzere olan 5 çekiliş.
Güvenlik modeli
Anahtarlar nxr_ ile başlar ve 192 bit entropi taşır. Sunucuda yalnızca bir SHA-256 karması saklanır. Ham anahtar üretim anında bir kez gösterilir ve geri alınamaz. Her yanıt iki kontrolden geçer: anahtar etkin mi, ve bu uç noktanın kapsamı açık mı? Bir kapsamı kapatmak anında 403 döndürür. Bir anahtarı devre dışı bırakmak veya iptal etmek, yeniden dağıtım gerekmeden tüm erişimi keser. Hız sınırı anahtar başına dakikada 60 istektir.
Başlarken (60 saniye)
- 1. Paneli aç, sunucunu seç ve API Erişimi bölümüne git.
- 2. API Anahtarı Oluştur'a tıkla ve değeri kopyala. Bu değer yalnızca bir kez gösterilir.
- 3. Kapsamları aç veya kapat. Her kapsamın kendi düğmesi var.
- 4.
curl https://noxyrbot.com/api/v1/server -H "Authorization: Bearer nxr_YOUR_KEY"komutunu çalıştır, işte bu kadar, canlısın.
Yaygın entegrasyonlar
Açılış sayfanda canlı bir üye sayacı göster. Özel bir personel kanalına haftalık bir bilet özeti gönder. En çok çekiliş katılımı yapan kişilerin herkese açık bir liderlik tablosunu oluştur. Satış verilerini bir elektronik tabloya veya kendi yönetici paneline bağla. Yanıtlar sade JSON ve gevşek CORS olduğu için, API'yi herhangi bir proxy olmadan tarayıcıdan çağırabilirsin.
Sırada ne var
İlgili okumalar: Discord API'si ile Noxyr Sunucu API'si karşılaştırması, adım adım bir öğretici, bu uç noktaların arkasındaki tasarım ilkeleri ve Discord API hatalarını nasıl ele aldığımız.