---
title: "Visão geral da API"
description: "O que a REST API faz, onde encontrá-la e como criar, alterar e publicar um site com ela."
canonical: "https://atelier201.com/docs/pt/api/overview"
updated: "2026-11-06"
---

# Visão geral da API

A API está em `https://api.atelier201.com/v1`. Ela faz tudo o que o app faz,
e a [CLI](/docs/cli/overview) e o [servidor MCP](/docs/mcp/overview) usam
o mesmo contrato.

## Sua primeira chamada

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

**Primeiro, consulte `/v1/account`.** Uma única solicitação informa o workspace, o plano
e exatamente quais escopos foram concedidos à credencial que você está usando. Descobrir
isso aos poucos, recebendo um 403 de cada vez, é o caminho mais lento.

## Do zero a um site publicado

Cada etapa corresponde a uma chamada. Só a última altera o que os visitantes veem.

1. [Crie um site](/docs/api/sites/create). Ele começa com o starter do Atelier201 e
   passa por uma build.
2. [Leia o modelo de conteúdo](/docs/api/content/model) e, em seguida, altere textos e
   entradas com [Criar ou atualizar uma entrada](/docs/api/content/save-entry) e
   [Alterar um campo](/docs/api/content/set-field).
3. [Inicie a build do site](/docs/api/builds/start) e consulte
   [a build](/docs/api/builds/retrieve) até que fique `ready`.
4. [Compartilhe uma prévia](/docs/api/previews/create) com a pessoa responsável pelo site.
5. [Faça a revisão](/docs/api/publishing/review) e, depois,
   [publique](/docs/api/publishing/publish) quando a pessoa responsável aprovar.

Veja os conceitos por trás de cada etapa em
[Como um site vai ao ar](/docs/platform/drafts-builds-and-publishing).

## Custos

Editar, fazer builds, visualizar prévias e publicar fazem parte do plano do site
e não consomem créditos. Há uma exceção: [gerar uma imagem ou um vídeo com
IA](/docs/api/media/generate), por um preço fixo que você recebe gratuitamente na primeira vez,
com a permissão específica `media:generate`. Consulte [Planos e créditos](/docs/platform/credits-and-plans).

## O que ela não faz

A API não é de streaming e não mantém uma conexão aberta. Ao iniciar uma build,
a solicitação retorna imediatamente com uma build `queued`; consulte o resultado depois.
A build continua mesmo que o cliente desconecte.