Votes

Vérification et consultation des votes 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.

• Le paramètre api_token reste supporté pour compatibilité, mais son usage est déconseillé.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

discord_idstring · max: 20Optional

ID Discord de l'utilisateur à vérifier.

Example: 511252691334660106Pattern: ^[0-9]{15,20}$

external_idstring · max: 191Optional

Identifiant externe de l'utilisateur.

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

is_doubledbooleanRequired

Indique si le vote d'un utilisateur est considéré comme doublé.

Example: false

last_vote_atstring · date-time · nullableRequiredExample: 2026-06-02T10:42:00.000Z

next_vote_atstring · date-time · nullableRequiredExample: 2026-06-02T11:42:00.000Z

cooldown_remaining_secondsintegerRequiredExample: 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

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,
  "is_doubled": false,
  "last_vote_at": null,
  "next_vote_at": null,
  "cooldown_remaining_seconds": 0
}

Récupérer les votes récents de sa guilde

get

Retourne la liste des votes de la guilde associée au token développeur sur une période donnée.

Important :

• Cette route est réservée aux serveurs Premium.

• La période demandée ne peut pas dépasser 31 jours.

• Les votes sont triés par timestamp croissant.

• La pagination utilise un curseur opaque (next_cursor).

• Le champ is_doubled indique si le vote est considéré comme doublé.

• Aucune donnée personnelle autre que l'ID Discord de l'utilisateur n'est retournée.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

fromstring · date-timeOptional

Date de début de la période à récupérer.

Format recommandé : ISO 8601. Si absent, l'API peut utiliser le début du mois courant.

Example: 2026-06-01T00:00:00.000Z

tostring · date-timeOptional

Date de fin de la période à récupérer.

Format recommandé : ISO 8601. Si absent, l'API peut utiliser la date courante.

Example: 2026-06-30T23:59:59.999Z

cursorstringOptional

Curseur opaque retourné par pagination.next_cursor. À réutiliser tel quel pour récupérer la page suivante.

Example: eyJjcmVhdGVkX2F0IjoiMjAyNi0wNi0wMlQxNToxMjo0NC4wMDBaIiwiaWQiOiI5ODQyMSJ9

limitinteger · min: 1 · max: 1000Optional

Nombre maximum d'éléments retournés. Valeur par défaut : 100. Valeur maximum : 1000.

Default: 100Example: 100

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

Liste paginée des votes de la guilde.

application/json

okbooleanRequiredExample: true

totalintegerRequired

Nombre total de votes logiques correspondant aux filtres demandés, sur la période. Ce total n'est pas limité par pagination.limit.

Example: 247

guild_idstringRequiredExample: 1013462556775551067

400

Erreurs liées aux dates ou au curseur.

application/json

401

Erreurs liées au token développeur.

application/json

403

La guilde associée au token n'a pas accès à cette route.

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/guild/votes

GET /v7/guild/votes HTTP/1.1
Host: api.discordtop.net
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "ok": true,
  "guild_id": "1013462556775551067",
  "votes": [
    {
      "user_id": "149505704569339904",
      "timestamp": "2026-06-02T14:32:00.000Z",
      "is_doubled": true
    },
    {
      "user_id": "511252691334660106",
      "timestamp": "2026-06-02T15:12:44.000Z",
      "is_doubled": false
    }
  ],
  "total": 247,
  "pagination": {
    "limit": 100,
    "has_more": true,
    "next_cursor": "eyJjcmVhdGVkX2F0IjoiMjAyNi0wNi0wMlQxNToxMjo0NC4wMDBaIiwiaWQiOiI5ODQyMSJ9"
  },
  "period": {
    "from": "2026-06-01T00:00:00.000Z",
    "to": "2026-06-30T23:59:59.999Z"
  }
}

Récupérer les votes récents d'un utilisateur sur sa guilde

get

Retourne la liste des votes d'un utilisateur précis sur la guilde associée au token développeur.

Important :

• Cette route est réservée aux serveurs Premium.

• La période demandée ne peut pas dépasser 31 jours.

• Le user_id est l'ID Discord de l'utilisateur.

• Les votes sont triés par timestamp croissant.

• La pagination utilise un curseur opaque (next_cursor).

• Aucune donnée personnelle autre que l'ID Discord de l'utilisateur n'est retournée.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

user_idstring · max: 20Required

ID Discord de l'utilisateur dont les votes doivent être récupérés.

Example: 149505704569339904Pattern: ^[0-9]{15,20}$

Query parameters

fromstring · date-timeOptional

Date de début de la période à récupérer.

Format recommandé : ISO 8601. Si absent, l'API peut utiliser le début du mois courant.

Example: 2026-06-01T00:00:00.000Z

tostring · date-timeOptional

Date de fin de la période à récupérer.

Format recommandé : ISO 8601. Si absent, l'API peut utiliser la date courante.

Example: 2026-06-30T23:59:59.999Z

cursorstringOptional

Curseur opaque retourné par pagination.next_cursor. À réutiliser tel quel pour récupérer la page suivante.

Example: eyJjcmVhdGVkX2F0IjoiMjAyNi0wNi0wMlQxNToxMjo0NC4wMDBaIiwiaWQiOiI5ODQyMSJ9

limitinteger · min: 1 · max: 1000Optional

Nombre maximum d'éléments retournés. Valeur par défaut : 100. Valeur maximum : 1000.

Default: 100Example: 100

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

Liste paginée des votes de l'utilisateur sur la guilde.

application/json

okbooleanRequiredExample: true

totalintegerRequired

Nombre total de votes logiques correspondant aux filtres demandés, sur la période. Ce total n'est pas limité par pagination.limit.

Example: 247

guild_idstringRequiredExample: 1013462556775551067

user_idstringRequired

ID Discord de l'utilisateur demandé.

Example: 149505704569339904

400

Erreurs liées à l'utilisateur, aux dates ou au curseur.

application/json

401

Erreurs liées au token développeur.

application/json

403

La guilde associée au token n'a pas accès à cette route.

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/guild/votes/users/{user_id}

GET /v7/guild/votes/users/{user_id} HTTP/1.1
Host: api.discordtop.net
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "ok": true,
  "guild_id": "1013462556775551067",
  "user_id": "149505704569339904",
  "votes": [
    {
      "user_id": "149505704569339904",
      "timestamp": "2026-06-02T14:32:00.000Z",
      "is_doubled": true
    }
  ],
  "total": 12,
  "pagination": {
    "limit": 100,
    "has_more": false,
    "next_cursor": null
  },
  "period": {
    "from": "2026-06-01T00:00:00.000Z",
    "to": "2026-06-30T23:59:59.999Z"
  }
}