API-Übersicht
Was die REST API leistet, wo sie zu finden ist und wie du damit einen Standort erstellst, bearbeitest und veröffentlichst.
Die API ist unter https://api.atelier201.com/v1 erreichbar. Sie bietet alle Funktionen der App. Auch die CLI und der MCP-Server verwenden denselben Vertrag.
Dein erster Aufruf
curl https://api.atelier201.com/v1/account \
-H "Authorization: Bearer $ATELIER201_API_KEY"Rufe zuerst /v1/account auf. Eine Anfrage zeigt dir den Workspace, den Tarif und genau, welche Berechtigungen für deine Zugangsdaten erteilt wurden. Diese Informationen einzeln durch 403-Fehler herauszufinden, dauert länger.
Von null zum veröffentlichten Standort
Jeder Schritt erfordert einen Aufruf. Nur der letzte ändert, was Besucher sehen.
- Standort erstellen. Er basiert auf dem Atelier201-Starter und wird einmal erstellt.
- Das Inhaltsmodell lesen, dann Texte und Einträge mit Einen Eintrag erstellen oder aktualisieren und Ein einzelnes Feld ändern bearbeiten.
- Standort erstellen und den Status von Build abrufen regelmäßig abfragen, bis er
readyist. - Vorschau teilen und dem Betreiber zeigen.
- Prüfen, dann nach der Freigabe durch den Betreiber veröffentlichen.
Die Hintergründe zu den einzelnen Schritten findest du unter So geht ein Standort live.
Kosten
Bearbeiten, Erstellen, Vorschau und Veröffentlichen sind im Tarif des Standorts enthalten und kosten keine Credits. Eine Ausnahme gibt es: Bilder oder Videos mit AI erstellen. Dieser Endpunkt hat einen festen Preis, den du zuerst kostenlos testen kannst, und erfordert die separate Berechtigung media:generate. Weitere Informationen unter Tarife und Credits.
Was die API nicht kann
Sie ist keine Streaming-API und hält keine Verbindung offen. Beim Starten eines Builds erhältst du sofort einen Build mit dem Status queued. Anschließend fragst du den Status ab. Der Build läuft auch weiter, wenn die Verbindung deines Clients getrennt wird.