Guild

Consultation des statistiques DiscordTop de la guilde associée au token développeur.

Récupérer les statistiques DiscordTop de sa guilde

get

Retourne les statistiques DiscordTop de la guilde associée au token développeur.

Important :

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

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

• La guilde doit être active sur DiscordTop.

• Les informations retournées sont uniquement des métriques DiscordTop.

Authorizations

ApiTokenAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

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

Statistiques DiscordTop de la guilde associée au token développeur.

application/json

okbooleanRequiredExample: true

guild_idstringRequiredExample: 1013462556775551067

votesintegerRequired

Nombre de votes de la guilde sur le classement mensuel en cours.

Example: 42

lifetime_votesintegerRequired

Nombre total de votes reçus par la guilde depuis son ajout sur DiscordTop.

Example: 1820

votes_last_7_daysintegerRequired

Nombre de votes reçus sur les 7 derniers jours.

Example: 15

rankinteger · nullableRequired

Position actuelle de la guilde dans le classement mensuel.

Example: 18

boostsintegerRequired

Nombre de boosts actifs sur la guilde.

Example: 3

reviewsintegerRequired

Nombre total d'avis publiés pour la guilde.

Example: 28

ratingnumber · float · nullableRequired

Note moyenne des avis publiés, arrondie à une décimale. Null si aucun avis n'est disponible.

Example: 4.7

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

429

Rate limit atteint.

application/json

500

Erreur interne de l'API.

application/json

get

/guild/me

HTTPcURLJavaScriptPython

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

{
  "ok": true,
  "guild_id": "1013462556775551067",
  "votes": 42,
  "lifetime_votes": 1820,
  "votes_last_7_days": 15,
  "rank": 18,
  "boosts": 3,
  "reviews": 28,
  "rating": 4.7
}