> For the complete documentation index, see [llms.txt](https://docs.dimdams.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.dimdams.com/demarrage-rapide.md).

# Démarrage rapide

Pour commencer à utiliser l'API Dimdam's, suivez ces étapes simples :

1. Obtenez une clé d'API en vous inscrivant sur [notre site](https://api.dimdams.com/login).
2. Utilisez votre clé d'API pour accéder aux différents endpoints de l'API Dimdam's.
3. Explorez les fonctionnalités de l'API en effectuant des requêtes vers les endpoints pertinents.

## Exemples

#### Exemple d'utilisation de la route `/v1/ask` :

{% hint style="info" %}
Cet exemple sera obsolète lors du déploiement de la V2 de l'API.
{% endhint %}

```javascript
const question = "Qu'est-ce qu'internet ?"; // Question à poser
const token = "Your token"; // Votre clé d'API

// Données de la requête
const requestData = {
    question: question
};

// Options de la requête
const requestOptions = {
    method: 'POST',
    headers: {
        'Content-Type': 'application/json',
        'Authorization': `${token}`
    },
    body: JSON.stringify(requestData)
};

// Effectuer la requête
fetch('https://api.dimdams.com/v1/ask', requestOptions)
    .then(response => {
        // Vérifier si la réponse est OK
        if (!response.ok) {
            throw new Error('La requête a échoué.');
        }
        // Renvoyer la réponse sous forme de JSON
        return response.json();
    })
    .then(data => {
        // Traiter la réponse
        console.log('Question:', data.question);
        console.log('Réponse:', data.answer);
    })
    .catch(error => {
        // Gérer les erreurs
        console.error('Erreur:', error.message);
    });
```

***

#### Exemple d'utilisation de la route `/v1/status` : 

```javascript
// Options de la requête
const requestOptions = {
    method: 'GET',
    headers: {
        'Content-Type': 'application/json'
    }
};

// Effectuer la requête
fetch('https://api.dimdams.com/v1/status', requestOptions)
    .then(response => {
        // Vérifier si la réponse est OK
        if (!response.ok) {
            throw new Error('La requête a échoué.');
        }
        // Renvoyer la réponse sous forme de JSON
        return response.json();
    })
    .then(data => {
        // Traiter la réponse
        console.log('Statut:', data.status);
        console.log('Temps de fonctionnement (uptime):', data.uptime, 'secondes');
        console.log('Taille des données:', data.datasSize, 'octets');
    })
    .catch(error => {
        // Gérer les erreurs
        console.error('Erreur:', error.message);
    });
```