# 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*](/api-reference/concepts-cles/versioning.md)

## 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*](/api-reference/concepts-cles/erreurs-and-codes-de-reponse.md)

## 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`


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.discordtop.net/api-reference/readme.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.