API resmi Discord adalah permukaan tingkat rendah yang dibuat untuk bot dan klien. Kamu bekerja dengan event gateway, melakukan caching secara manual, dan mengatur intent. Noxyr Server API adalah API HTTP tingkat tinggi yang dibatasi pada satu server dan mengembalikan analitik yang sudah jadi. Keduanya memecahkan masalah yang berbeda. Berikut kapan sebaiknya memakai masing-masing.

Discord's gateway events and the Noxyr Server API's simple GET request both feed into your app. Discord API Gateway Noxyr API GET /v1 JSON Your app react to events read live stats

Apa yang diberikan API Discord

Dokumentasi API Discord (sangat sering dicari, Google Trends menunjukkan pencarian "discord api documentation" naik 700% dibanding tahun sebelumnya) adalah sumber kebenaran untuk apa pun yang dimiliki Discord sendiri: pesan, user, guild, role, channel, voice, thread, dan moderasi. Kamu mendapatkan REST API untuk aksi dan gateway WebSocket untuk event. Membangun apa pun yang real-time memerlukan koneksi persisten, penanganan READY dan heartbeat, invalidasi cache, dan bucket rate limit.

Apa yang diberikan Noxyr Server API

Noxyr Server API jauh lebih kecil: enam endpoint read-only yang dibatasi pada satu server melalui bearer token. API ini menjawab pertanyaan seperti "berapa tiket bulan ini?" atau "pendapatan per mata uang", yang sama sekali tidak bisa dijawab API Discord, karena data di baliknya tersimpan di database Noxyr, bukan di Discord.

Perbandingan berdampingan

  • Auth: Discord memakai OAuth2 atau token bot dengan intent. Noxyr memakai satu bearer token per server.
  • Transport: Discord memakai REST + gateway WebSocket. Noxyr memakai HTTPS biasa dengan CORS aktif untuk browser.
  • Cakupan: Discord bersifat global untuk bot-mu di setiap server tempat ia berada. Noxyr terikat pada satu server tertentu.
  • Bentuk data: Discord mengembalikan objek mentah: guild, member, pesan. Noxyr mengembalikan agregat, total, rata-rata, dan bucket harian.
  • Rate limit: Discord memakai batas bucket per route. Noxyr memakai batas datar 60 request/menit per key.
  • Usaha setup: Discord membutuhkan aplikasi bot, undangan, intent, dan event handler. Noxyr cukup satu klik untuk membuat key.

Pilih Discord ketika…

  • Kamu membutuhkan event real-time (pesan masuk, member bergabung, voice channel berubah).
  • Kamu ingin mengirim pesan, mengedit channel, mem-ban user, atau mengelola role dari aplikasimu.
  • Kamu sedang membangun bot Discord atau klien Discord pihak ketiga.

Pilih Noxyr Server API ketika…

  • Kamu ingin menampilkan statistik server secara langsung di website publik tanpa harus mengelola bot.
  • Kamu membutuhkan analitik tiket, data penjualan, rata-rata review, atau partisipasi giveaway, data yang tidak disimpan Discord.
  • Kamu ingin JSON yang ramah CORS dan bisa dipanggil dari dashboard browser tanpa proxy.
  • Kamu ingin permukaan yang stabil dan berversi, di mana toggle scope memungkinkanmu menghentikan paparan data tanpa perlu deploy ulang apa pun.

Memakai keduanya bersama

Kedua API ini cocok dipadukan. Pakai API Discord di bot-mu sendiri untuk bereaksi terhadap event, dan pakai Noxyr Server API untuk membaca kondisi agregat di website-mu. Dengan begitu, dashboard publikmu tidak perlu intent bot atau koneksi gateway sama sekali. Satu permintaan HTTPS sudah cukup.

Bacaan lainnya: tutorial Server API, prinsip desain, menangani error API Discord.