> ## Documentation Index
> Fetch the complete documentation index at: https://docs.marcodewey.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Démarrage rapide

> Exécutez les quatre API de démo en local et essayez-les depuis le bac à sable d'API de ce site.

Vous pouvez lire tout ce site sans rien exécuter. Pour utiliser le bac à sable **Try it**, exécutez une API sur votre ordinateur.

changement

marco apporte des modifications

nouvelle ligne. test.

**1. Vérifiez ce dont vous avez besoin**

Vous avez besoin de Python 3.10 ou version ultérieure et de `git`.

> [tab] macOS
>
> ```bash theme={null}
> brew install python git
> ```

> [tab] Linux
>
> ```bash theme={null}
> sudo apt install python3 python3-venv git
> ```

> [tab] Windows
>
> ```powershell theme={null}
> winget install Python.Python.3.12 Git.Git
> ```

**2. Choisissez une API et démarrez-la**

```bash Merge Sort API theme={null}
git clone https://github.com/mintlify-demo/merge-sort-api.git
cd merge-sort-api
python3 -m venv .venv && source .venv/bin/activate
pip install -r requirements.txt
uvicorn main:app --reload
```

```bash Calculator API theme={null}
git clone https://github.com/mintlify-demo/calculator-api.git
cd calculator-api
python3 -m venv .venv && source .venv/bin/activate
pip install -r requirements.txt
uvicorn main:app --reload
```

```bash Todo API theme={null}
git clone https://github.com/mintlify-demo/todo-api.git
cd todo-api
python3 -m venv .venv && source .venv/bin/activate
pip install -r requirements.txt
uvicorn main:app --reload
```

```bash Text Utils API theme={null}
git clone https://github.com/mintlify-demo/text-utils-api.git
cd text-utils-api
python3 -m venv .venv && source .venv/bin/activate
pip install -r requirements.txt
uvicorn main:app --reload
```

> [!WARNING]
>
> Toutes les API utilisent le port `8000`. Exécutez-en une à la fois, ou démarrez les autres avec `--port 8001`.

**3. Ouvrez sa référence d'API**

Choisissez l'onglet correspondant en haut de ce site, sélectionnez un endpoint et cliquez sur **Try it**. Le bac à sable envoie la requête depuis votre navigateur directement à `http://localhost:8000`.

**4. Envoyez une requête**

Pour la Todo API, saisissez `demo-key` comme clé d'API. Aucune autre API ne nécessite de clé.

> [!TIP]
>
> Vous exécutez une vraie API et l'appelez depuis une documentation générée.

> [!TIP]
>
> Vous faites une démonstration en direct ? Démarrez l'API avant l'appel et gardez votre navigateur sur la page de l'endpoint. Le bac à sable, les exemples de code et la visionneuse de réponses se mettent tous à jour pendant la saisie.

## Dépannage

> [accordion] Le bac à sable indique qu'il ne peut pas joindre le serveur
>
> Assurez-vous que l'API est en cours d'exécution et affiche `Uvicorn running on http://127.0.0.1:8000`. Les API autorisent les requêtes cross-origin, aucune configuration supplémentaire n'est donc nécessaire.

> [accordion] `pip install` échoue
>
> Vérifiez que vous avez activé l'environnement virtuel : votre invite de commande doit commencer par `(.venv)`.

> [accordion] Le port 8000 est déjà utilisé
>
> Arrêtez l'autre API, ou exécutez `uvicorn main:app --port 8001`.

## Comment ce site est construit

Le code et les tests de chaque API se trouvent dans le dépôt de cette API. Toute la documentation, y compris les guides et la spécification OpenAPI de chaque API, se trouve dans le [dépôt de la documentation](https://github.com/mintlify-demo/docs). Lorsque le code d'une API change, l'agent de Mintlify ouvre une pull request dans le dépôt de la documentation avec la mise à jour correspondante.

```mermaid theme={null}
flowchart LR
    A[merge-sort-api] -- modification du code --> M{{Agent Mintlify}}
    B[calculator-api] -- modification du code --> M
    C[todo-api] -- modification du code --> M
    D[text-utils-api] -- modification du code --> M
    M -- PR de documentation --> E[docs]
    E --> S[Un seul site de documentation]
```

> [card] [Composants](https://docs.marcodewey.com/fr/showcase/components.md)
>
> Tous les éléments de base utilisés sur ce site.

> [card] [Fonctionnalités d'IA](https://docs.marcodewey.com/fr/showcase/ai.md)
>
> L'assistant, llms.txt, le serveur MCP et plus encore.
