# Introduction

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 :

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

Exemple :

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

{% hint style="warning" %}
Les requêtes non chiffrées (HTTP) ne sont pas autorisées.
{% endhint %}

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*](https://docs.discordtop.net/api-reference/concepts-cles/versioning)

## Format des réponses JSON

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

Exemple générique :

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

En cas d’erreur :

```json
{
  "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*](https://docs.discordtop.net/api-reference/concepts-cles/erreurs-and-codes-de-reponse)

## Convention HTTP

L’API suit des conventions simples :

<table data-header-hidden><thead><tr><th width="252">Élément</th><th>Descriptions</th></tr></thead><tbody><tr><td>Méthodes</td><td>Les endpoints utilisent principalement <code>GET</code></td></tr><tr><td>Corps de requête</td><td>Non utilisé sur les endpoints publics actuels</td></tr><tr><td>Paramètres</td><td>Transmis via query string (<code>?key=value</code>)</td></tr><tr><td>En-têtes</td><td>Standard HTTP (User-Agent recommandé)</td></tr><tr><td>Codes HTTP</td><td>Utilisés de manière cohérente (<code>200</code>, <code>400</code>, <code>401</code>, <code>404</code>, <code>429</code>, etc.)</td></tr></tbody></table>

Structure d’un appel typique :

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

## Règles de base de l’API

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

#### &#x20;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`