Vérification des votes

Le système pour vérification les votes des utilisateurs.

Vérifier si un utilisateur est en cooldown de vote

get

Vérifie si un utilisateur (via discord_id ou external_id) a voté pour la guilde associée au token développeur dans la dernière heure.

Important :

• Un seul identifiant doit être fourni.

• Le cooldown est fixé à 1h.

• Le token doit être passé en Bearer ou via X-Api-Token.

Authorizations

ApiTokenAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

discord_idstring · max: 20Optional

ID Discord de l'utilisateur à vérifier.

Example: 511252691334660106

external_idstring · max: 191Optional

Identifiant externe de l’utilisateur (site, jeu…).

Example: my-user-123456

api_tokenstringOptionalDeprecated

Ancienne méthode pour passer le token dans l'URL. Il est recommandé d'utiliser Authorization: Bearer <token>.

Example: dtop_dev_xxx123

localestringOptional

Force la langue de la réponse (fr, en, etc.). Si absent : utilise X-Locale, puis Accept-Language, sinon fallback en.

Example: fr

Header parameters

X-LocalestringOptional

Locale forcée (surpasse Accept-Language).

Example: en

Accept-LanguagestringOptional

Détection automatique de la langue.

Example: fr-FR,fr;q=0.9,en;q=0.8

X-Api-TokenstringOptional

Token développeur alternatif.

Example: dtop_dev_abc123

Responses

200

Résultat de vérification du vote.

application/json

okbooleanRequiredExample: true

guild_idstringRequiredExample: 1013462556775551067

has_votedbooleanRequired

true → l’utilisateur est encore dans le cooldown
false → aucun vote récent OU cooldown terminé

Example: false

last_vote_atstring · nullableRequiredExample: 2025-12-09T10:42:00.000Z

next_vote_atstring · nullableRequiredExample: 2025-12-09T11:42:00.000Z

cooldown_remaining_secondsintegerOptionalExample: 0

400

Erreurs liées aux identifiants fournis.

application/json

401

Erreurs liées au token développeur.

application/json

422

Erreurs de validation (Adonis Validator).

application/json

429

Rate limit atteint.

application/json

500

Erreur interne de l’API.

application/json

get

/vote-check

HTTPcURLJavaScriptPython

GET /v7/vote-check HTTP/1.1
Host: api.discordtop.net
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "ok": true,
  "guild_id": "1013462556775551067",
  "has_voted": false,
  "last_vote_at": null,
  "next_vote_at": null
}