---
title: "Panoramica dell’API"
description: "Cosa fa la REST API, dove si trova e come creare, modificare e pubblicare un sito con essa."
canonical: "https://atelier201.com/docs/it/api/overview"
updated: "2026-11-06"
---

# Panoramica dell’API

L’API è disponibile all’indirizzo `https://api.atelier201.com/v1`. Offre tutte le
funzionalità dell’app e condivide lo stesso contratto con la [CLI](/docs/cli/overview)
e il [server MCP](/docs/mcp/overview).

## La prima richiesta

```bash
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.

1. [Crea un sito](/docs/api/sites/create). Parte dal modello Starter di Atelier201 e
   viene compilato una volta.
2. [Consulta il modello dei contenuti](/docs/api/content/model), poi modifica testi e
   voci con [Crea o aggiorna una voce](/docs/api/content/save-entry) e
   [Modifica un campo](/docs/api/content/set-field).
3. [Crea la build del sito](/docs/api/builds/start) e controlla
   [la build](/docs/api/builds/retrieve) finché non è `ready`.
4. [Condividi un’anteprima](/docs/api/previews/create) e mostrala al proprietario.
5. [Esamina](/docs/api/publishing/review), poi
   [pubblica](/docs/api/publishing/publish) dopo l’approvazione del proprietario.

Per i concetti alla base di ogni passaggio, consulta
[Come va online un sito](/docs/platform/drafts-builds-and-publishing).

## 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](/docs/api/media/generate), a un prezzo fisso con la prima generazione gratuita,
protetta dall’autorizzazione specifica `media:generate`. Consulta [Piani e crediti](/docs/platform/credits-and-plans).

## 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.