Editor visual da vitrine

O editor visual é a forma de montar a vitrine por seções: blocos prontos (banner, produtos em destaque, texto, newsletter...) que você coloca em contêineres da página, reordena e configura. A API trabalha sempre sobre um rascunho: nada aparece para o cliente até você publicar. Esta seção mostra como ler a página atual, editar o rascunho e publicar. Todas as rotas exigem token de administrador com o privilégio manage_layouts.

Como funciona

1. Leia a página atual
   GET /api/v1/admin/editor/layout/{pageType} devolve os contêineres e seções publicados, o layout_id e se já existe rascunho (has_draft).
2. Escolha seções
   GET /api/v1/admin/editor/templates lista as seções prontas, com os campos configuráveis de cada uma.
3. Edite o rascunho
   Adicione, remova, reordene e configure seções (rotas de seções), ou grave o rascunho inteiro de uma vez (rota de rascunho).
4. Publique ou descarte
   POST .../publish torna o rascunho a página real. DELETE .../draft/{layoutId} joga o rascunho fora.

Conceitos-chave

Página, contêiner e seção

Uma página tem contêineres (áreas como top_panel, header, content, footer), e cada contêiner tem seções em ordem. Uma seção é uma instância de um modelo de seção (template_slug, por exemplo hero-banner), com sua config (as opções preenchidas) e visible.

O pageType é um "dispatch"

O parâmetro pageType de GET /editor/layout/{pageType} é o nome interno da página: index.index (inicial), products.view (produto), categories.view (categoria), checkout.cart (carrinho), blog.view, search.view, vendors.view e assim por diante. O servidor ecoa o valor que você mandou em page_type, e um valor desconhecido cai no layout da página inicial em vez de dar erro. O apelido homepage também funciona.

Publicar escreve na página padrão do layout

O rascunho é guardado por layout, não por página, e a publicação grava os contêineres na página padrão do layout (a página "catch-all"). Se você leu a página products.view e publicou o rascunho, o conteúdo vai para a página padrão do layout, não para a página de produto. Em lojas cujo layout tem páginas separadas por tipo, confirme na vitrine o efeito antes de publicar e prefira as rotas de advanced-layouts para editar uma página específica.

Identificadores

Endpoints

Erros comuns

• Publicar sem rascunho. Retorna 500 (no draft exists for layout N). Confira has_draft antes.
• Esquecer o position ao adicionar seção. O valor padrão é 0: a seção entra no topo do contêiner, não no fim.
• Gravar o rascunho com lista de contêineres incompleta e publicar. Contêineres que não estão no rascunho são apagados da página publicada (se o rascunho tiver ao menos um contêiner).
• Achar que a edição é por usuário. O rascunho é único por layout: releia antes de gravar.
• Usar section_ids incompleto no reordenar. Seções que você não listar vão para o fim; id desconhecido gera 500.
• Mandar só a opção alterada em config esperando substituir tudo. Aqui o config é mesclado chave a chave, diferente dos layouts simples.

Próximos passos