📘Introduction

Bienvenue dans la référence officielle de l’API DiscordTop.

Cette page présente les fondations techniques de l’API DiscordTop : comment y accéder, dans quel format elle répond, et quelles conventions elle utilise.

Pour des informations plus détaillées (authentification, erreurs, versioning…), consultez les pages dédiées dans la section API Reference.

Accès à l’API

L’API DiscordTop est accessible via l’URL suivante :

https://api.discordtop.net/v{VERSION}/

Exemple :

https://api.discordtop.net/v7/check-vote

Les requêtes non chiffrées (HTTP) ne sont pas autorisées.

La version est un élément obligatoire de toutes les routes (/v7/). Chaque version représente un contrat stable.

Pour plus d’informations : ➡️ Voir : Versioning

Format des réponses JSON

L’API DiscordTop renvoie uniquement des réponses au format JSON UTF-8.

Exemple générique :

{
  "ok": true,
  "data": { ... }
}

En cas d’erreur :

{
  "ok": false,
  "error": "ERROR_CODE",
  "message": "Description de l'erreur."
}

La liste complète des codes d’erreur est disponible ici : ➡️ Voir : Erreurs & Codes de réponse

Convention HTTP

L’API suit des conventions simples :

Méthodes	Les endpoints utilisent principalement GET
Corps de requête	Non utilisé sur les endpoints publics actuels
Paramètres	Transmis via query string (?key=value)
En-têtes	Standard HTTP (User-Agent recommandé)
Codes HTTP	Utilisés de manière cohérente (200, 400, 401, 404, 429, etc.)

Structure d’un appel typique :

GET https://api.discordtop.net/v7/check-vote?param=value

Règles de base de l’API

Avant d’exploiter les endpoints, voici les principes fondamentaux à connaître :

1. Toutes les réponses sont application/json

Aucun autre format n’est jamais renvoyé.

2. Toutes les routes commencent par /v{VERSION}/

Aucune route sans version n’est supportée.

3. La structure des champs est stable

Les champs non documentés ne doivent pas être utilisés.

4. L’API est strictement case-sensitive

Les noms de paramètres et valeurs doivent respecter la casse.

5. L’API ne renvoie jamais d’HTML

Même en cas d’erreur → toujours JSON.

6. Le fuseau horaire est toujours en ISO 8601

Format : YYYY-MM-DDTHH:mm:ss.sss+TZ