Présentation de l’API
Fonctionnement de l’API REST, son adresse et la création, la modification et la publication d’un site avec celle-ci.
L’API est accessible à l’adresse https://api.atelier201.com/v1. Elle permet de faire tout ce que l’application permet,
et la CLI ainsi que le serveur MCP utilisent
le même contrat.
Votre premier appel
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.
- Créer un site. Il démarre à partir du modèle Atelier201 Starter et est compilé une fois.
- Lire le modèle de contenu, puis modifier les textes et les entrées avec Créer ou mettre à jour une entrée et Modifier un champ.
- Compiler le site, puis interroger
la compilation jusqu’à ce que son état soit
ready. - Partager un aperçu et le présenter au propriétaire.
- Vérifier, puis publier après l’approbation du propriétaire.
Les notions associées à chaque étape sont expliquées dans Comment un site est mis en ligne.
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, à un tarif fixe, avec une première utilisation offerte, protégée par
l’autorisation spécifique media:generate. Consultez Offres et crédits.
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.