---
title: "Présentation de l’API"
description: "Fonctionnement de l’API REST, son adresse et la création, la modification et la publication d’un site avec celle-ci."
canonical: "https://atelier201.com/docs/fr/api/overview"
updated: "2026-11-06"
---

# Présentation de l’API

L’API est accessible à l’adresse `https://api.atelier201.com/v1`. Elle permet de faire tout ce que l’application permet,
et la [CLI](/docs/cli/overview) ainsi que le [serveur MCP](/docs/mcp/overview) utilisent
le même contrat.

## Votre premier appel

```bash
curl https://api.atelier201.com/v1/account \
  -H "Authorization: Bearer $ATELIER201_API_KEY"
```

**Commencez par appeler `/v1/account`.** Une seule requête vous indique l’espace de travail, l’offre et
les autorisations précises accordées à vos identifiants. Les découvrir au fil des erreurs 403
est la méthode la plus lente.

## De zéro à un site en ligne

Chaque étape correspond à un appel. Seule la dernière modifie ce que voient les visiteurs.

1. [Créer un site](/docs/api/sites/create). Il démarre à partir du modèle Atelier201 Starter et
   est compilé une fois.
2. [Lire le modèle de contenu](/docs/api/content/model), puis modifier les textes et
   les entrées avec [Créer ou mettre à jour une entrée](/docs/api/content/save-entry) et
   [Modifier un champ](/docs/api/content/set-field).
3. [Compiler le site](/docs/api/builds/start), puis interroger
   [la compilation](/docs/api/builds/retrieve) jusqu’à ce que son état soit `ready`.
4. [Partager un aperçu](/docs/api/previews/create) et le présenter au propriétaire.
5. [Vérifier](/docs/api/publishing/review), puis
   [publier](/docs/api/publishing/publish) après l’approbation du propriétaire.

Les notions associées à chaque étape sont expliquées dans
[Comment un site est mis en ligne](/docs/platform/drafts-builds-and-publishing).

## Coûts

La modification, la compilation, la prévisualisation et la publication sont comprises dans l’offre du site
et ne consomment aucun crédit. Un seul endpoint est payant : [la création d’une image ou d’une vidéo par
IA](/docs/api/media/generate), à un tarif fixe, avec une première utilisation offerte, protégée par
l’autorisation spécifique `media:generate`. Consultez [Offres et crédits](/docs/platform/credits-and-plans).

## Ce que l’API ne fait pas

Ce n’est pas une API de streaming et elle ne maintient pas la connexion ouverte. Le lancement d’une
compilation renvoie immédiatement une compilation `queued`, dont vous pouvez ensuite interroger l’état.
La compilation se poursuit même si votre client se déconnecte.