Visão geral da API
O que a REST API faz, onde encontrá-la e como criar, alterar e publicar um site com ela.
A API está em https://api.atelier201.com/v1. Ela faz tudo o que o app faz,
e a CLI e o servidor MCP usam
o mesmo contrato.
Sua primeira chamada
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.
- Crie um site. Ele começa com o starter do Atelier201 e passa por uma build.
- Leia o modelo de conteúdo e, em seguida, altere textos e entradas com Criar ou atualizar uma entrada e Alterar um campo.
- Inicie a build do site e consulte
a build até que fique
ready. - Compartilhe uma prévia com a pessoa responsável pelo site.
- Faça a revisão e, depois, publique quando a pessoa responsável aprovar.
Veja os conceitos por trás de cada etapa em Como um site vai ao ar.
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, 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.
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.