Noxyr propose désormais une API REST gratuite, par serveur, pour récupérer des données Discord en direct : nombre de membres, analyses de tickets, indicateurs d'activité, ventes, avis et concours, dans votre site web, votre tableau de bord, votre application mobile ou un autre bot. Une clé par serveur, générée depuis le tableau de bord, sécurisée par un hachage SHA-256 et contrôlée par des interrupteurs de portée que vous gérez.

An authenticated API request reaches the Noxyr server and returns JSON with a depleting rate limit. GET /api/v1/server Authorization: Bearer •••••• Noxyr API { "id": "48213" "prefix": "!" "premium": true } RateLimit 60 33 60

Pourquoi une API limitée à un serveur ?

La plupart des bots Discord n'exposent aucune donnée, ou vous obligent à vous débattre avec l'API brute de Discord, ses intents, ses connexions gateway et les calculs de limitation de débit. L'API serveur de Noxyr fait l'inverse : vous envoyez un en-tête, vous recevez du JSON. Six points d'accès couvrent les questions que se posent réellement les propriétaires de serveurs : combien de membres, combien de tickets cette semaine, chiffre d'affaires par devise, note moyenne des avis, concours en cours, tendance d'activité quotidienne.

Ce que vous pouvez lire aujourd'hui

  • GET /api/v1/server : nom du serveur, URL de l'icône, nombre de membres en direct, nombre de membres en ligne, boosts, date de création.
  • GET /api/v1/tickets : total, ouverts et fermés, tickets ouverts au cours des 7 et 30 derniers jours, fermés au cours des 7 derniers jours, note moyenne et nombre d'évaluations.
  • GET /api/v1/activity?days=30 : messages, arrivées et départs quotidiens sur 90 jours au maximum, avec remplissage à zéro pour que chaque date soit présente.
  • GET /api/v1/invoices : nombre de factures, volume et chiffre d'affaires sur 7 et 30 jours par devise, plus la répartition par statut de paiement.
  • GET /api/v1/reviews : nombre total d'avis publiés, note moyenne, répartition de 1 à 5 étoiles et les 5 derniers avis (produit, note, texte court, auteur).
  • GET /api/v1/giveaways : nombre de concours actifs et terminés, total des participations et les 5 concours en cours qui se terminent en premier.

Modèle de sécurité

Les clés commencent par nxr_ et portent 192 bits d'entropie. Seul un hachage SHA-256 est stocké sur le serveur ; la clé brute n'est affichée qu'une fois, au moment de sa génération, et ne peut pas être récupérée. Chaque réponse passe par deux contrôles : la clé est-elle active, et la portée de ce point d'accès est-elle activée ? Désactiver une portée renvoie immédiatement une erreur 403 ; désactiver ou révoquer une clé coupe tout accès sans redéploiement. La limitation de débit s'applique par clé, à 60 requêtes par minute.

Démarrer (60 secondes)

  • 1. Ouvrez le tableau de bord, choisissez votre serveur et allez dans Accès API.
  • 2. Cliquez sur Générer une clé API et copiez la valeur ; c'est la seule fois où elle est affichée.
  • 3. Activez ou désactivez les portées. Chaque portée a son propre interrupteur.
  • 4. Appelez curl https://noxyrbot.com/api/v1/server -H "Authorization: Bearer nxr_YOUR_KEY" et c'est en ligne.

Intégrations courantes

Affichez un compteur de membres en direct sur votre page d'accueil. Publiez un résumé hebdomadaire des tickets dans un salon privé du staff. Créez un classement public de la participation aux concours. Reliez les données de ventes à un tableur ou à votre propre panneau d'administration. Comme les réponses sont du JSON simple avec un CORS permissif, vous pouvez appeler l'API depuis un navigateur sans passer par un proxy.

La suite

À lire aussi : L'API Discord contre l'API serveur Noxyr, un tutoriel pas à pas, les principes de conception derrière ces points d'accès et la façon dont nous gérons les erreurs de l'API Discord.