Panoramica dell’API
Cosa fa la REST API, dove si trova e come creare, modificare e pubblicare un sito con essa.
L’API è disponibile all’indirizzo https://api.atelier201.com/v1. Offre tutte le
funzionalità dell’app e condivide lo stesso contratto con la CLI
e il server MCP.
La prima richiesta
curl https://api.atelier201.com/v1/account \
-H "Authorization: Bearer $ATELIER201_API_KEY"Per prima cosa, chiama /v1/account. Una sola richiesta ti dice qual è il
workspace, qual è il piano e quali autorizzazioni sono state concesse esattamente
alla credenziale in tuo possesso. Scoprirlo un errore 403 alla volta è il modo più lento.
Da zero a un sito online
Ogni passaggio richiede una chiamata. Solo l’ultimo modifica ciò che vedono i visitatori.
- Crea un sito. Parte dal modello Starter di Atelier201 e viene compilato una volta.
- Consulta il modello dei contenuti, poi modifica testi e voci con Crea o aggiorna una voce e Modifica un campo.
- Crea la build del sito e controlla
la build finché non è
ready. - Condividi un’anteprima e mostrala al proprietario.
- Esamina, poi pubblica dopo l’approvazione del proprietario.
Per i concetti alla base di ogni passaggio, consulta Come va online un sito.
Costi
Modificare, creare build, visualizzare anteprime e pubblicare fanno parte del piano
del sito e non consumano crediti. C’è un’eccezione: generare un’immagine o un video con
l’AI, a un prezzo fisso con la prima generazione gratuita,
protetta dall’autorizzazione specifica media:generate. Consulta Piani e crediti.
Cosa non fa
Non è un’API di streaming e non mantiene aperta la connessione. L’avvio di una build
risponde subito con una build queued; poi devi controllarne l’esito. La build continua
anche se il client si disconnette.