L'API Discord officielle est une interface bas niveau conçue pour les bots et les clients : vous manipulez les événements de la passerelle, gérez le cache manuellement et jonglez avec les intents. L'API serveur Noxyr est une API HTTP haut niveau, limitée à un seul serveur, qui renvoie des analyses déjà calculées. Elles résolvent des problèmes différents. Voici quand utiliser l'une ou l'autre.
Ce que vous offre l'API Discord
La documentation de l'API Discord (très recherchée : Google Trends montre que les requêtes « discord api documentation » ont augmenté de 700 % d'une année sur l'autre) est la source de référence pour tout ce que Discord gère lui-même : messages, utilisateurs, serveurs, rôles, salons, vocal, fils de discussion, modération. Vous disposez d'une API REST pour les actions et d'une passerelle WebSocket pour les événements. Toute fonctionnalité en temps réel exige d'ouvrir une connexion persistante, de gérer READY et les heartbeats, l'invalidation du cache et les buckets de limitation de débit.
Ce que vous offre l'API serveur Noxyr
L'API serveur Noxyr est une surface beaucoup plus réduite : six endpoints en lecture seule, limités à un seul serveur via un token bearer. Elle répond à des questions comme « combien de tickets ce mois-ci ? » ou « chiffre d'affaires par devise », auxquelles l'API Discord ne peut pas répondre du tout, car les données sous-jacentes se trouvent dans la base de données de Noxyr et non sur Discord.
Comparaison côte à côte
- Authentification : Discord utilise OAuth2 ou des tokens de bot avec des intents. Noxyr utilise un seul token bearer par serveur.
- Transport : Discord repose sur REST et la passerelle WebSocket. Noxyr utilise du HTTPS classique avec CORS activé pour les navigateurs.
- Périmètre : Discord est global pour votre bot, sur tous les serveurs où il se trouve. Noxyr est lié à un serveur précis.
- Forme des données : Discord renvoie des objets bruts : serveurs, membres, messages. Noxyr renvoie des agrégats, des totaux, des moyennes et des données par jour.
- Limites de débit : Discord applique des limites par buckets selon la route. Noxyr applique une limite fixe de 60 requêtes par minute et par clé.
- Effort de mise en place : Discord exige une application de bot, une invitation, des intents et des gestionnaires d'événements. Noxyr ne demande qu'un clic pour générer une clé.
Choisissez Discord quand…
- Vous avez besoin d'événements en temps réel (un message arrivé, un membre qui rejoint, un salon vocal modifié).
- Vous voulez envoyer des messages, modifier des salons, bannir des utilisateurs ou gérer des rôles depuis votre application.
- Vous construisez un bot Discord ou un client Discord tiers.
Choisissez l'API serveur Noxyr quand…
- Vous voulez afficher des statistiques de serveur en direct sur un site public sans maintenir de bot.
- Vous avez besoin d'analyses de tickets, de données de ventes, de moyennes d'avis ou de participation aux giveaways, des données que Discord ne stocke pas.
- Vous voulez un JSON compatible CORS que vous pouvez appeler depuis un tableau de bord dans le navigateur, sans proxy.
- Vous voulez une surface stable et versionnée, où les interrupteurs de scope vous permettent de couper l'exposition de données sans rien redéployer.
Utiliser les deux ensemble
Les deux API se complètent bien. Utilisez l'API Discord dans votre propre bot pour réagir aux événements, et l'API serveur Noxyr pour lire l'état agrégé sur votre site. Ainsi, votre tableau de bord public n'a besoin ni d'intents de bot ni de connexion à la passerelle : une seule requête HTTPS suffit.
Pour aller plus loin : tutoriel de l'API serveur, principes de conception, gestion des erreurs de l'API Discord.