Démarrage rapide
Bienvenue dans le guide de démarrage rapide de l’API DiscordTop.
En moins de 5 minutes, vous allez :
Obtenir votre clé API
Faire votre premier appel à l’endpoint
/v7/check-voteComprendre comment interpréter la réponse
Intégrer la logique dans votre bot, CMS ou site web
Il est nécessaire d'avoir la permission ADMINISTRATOR sur le serveur Discord visés !
🧩 Obtenir votre clé API
Votre clé API est liée à votre serveur Discord. Elle permet d’authentifier vos requêtes et doit rester secrète.
Pour récupérer votre clé API :
Rendez-vous sur le tableau de bord DiscordTop
Allez dans Développeur & API
Cliquez sur Générer ma clé API
Copiez-la et stockez-la dans une variable d’environnement


Stockez votre clé API dans une variable d'environnement, par exemple :
⚠️ Ne partagez jamais votre clé API publiquement.
⚠️ Ne l’envoyez jamais dans votre front-end (seulement côté serveur).
🔌 Faire votre premier appel
L’endpoint principal est :
Vous pouvez identifier un utilisateur de deux façons :
👉 Avec son discord_id
(identifiant Discord, recommandé si vous avez un bot où si vous utilisez l'oAuth2)
👉 Avec un external_id
(pseudo Minecraft, identifiant de site, ID interne, etc.)
Exemple : vérifier un vote via discord_id
discord_idExemple en JavaScript (Node)
📥Réponse
Exemple de réponse complète :
Résumé logique :
has_voted = true→ L’utilisateur a voté cette dernière heurehas_voted = false→ L’utilisateur n'a pas voté sur les 60 dernières minutes (1h)
🧪 Exemple d’intégration simple
Bot Discord (JavaScript)
Exemple : vérifier un vote via external_id
external_idCas typiques d’utilisation :
vérifier les votes d’un joueur Minecraft (pseudo)
vérifier les votes d’un compte d’un site web (ID utilisateur)
synchroniser un système interne à votre projet
Attention, l'utilisation du external_id nécessite un lien de vote personnalisé afin que les données puissent être utilisées ! Ce système n'est pas compatible avec le vote depuis le bot DTOP !
Exemple de lien de vote :
Vous trouverez plus de détail dans la section dédié.
Last updated