Templates, versões e publicação

O catálogo informa os modelos base disponíveis e seus limites. Cada template pertence a um aplicativo. A personalização precisa estar habilitada nesse aplicativo; a existência de uma chave com permissão não habilita o recurso automaticamente.

Editar e conferir

Crie um template a partir do catálogo, altere seu nome e mantenha o conteúdo em um rascunho. O nome e o rascunho têm revisões independentes. Configurações e campos desconhecidos são validados pelo schema e pelas regras do modelo. Uma imagem precisa ser um ativo autorizado e ativo do mesmo aplicativo.

A validação normaliza a configuração. O preview devolve a configuração e o conteúdo resolvido, com sideEffects: false; ele não publica uma página, não registra eventos de visita e não comprova associação nativa. Variáveis obrigatórias para um link podem impedir que a configuração seja usada como padrão, pois os demais links precisam continuar válidos.

Preparar uma versão

Criar uma versão captura um snapshot imutável do rascunho. Informe a revisão do template no If-Match e a revisão do rascunho no corpo. A versão preparada ainda precisa ser publicada e confirmada antes de ser selecionada em páginas públicas.

Versões preservam suas imagens e configurações. Arquivar o template retira o item da seleção normal; não apaga snapshots ou remove referências históricas. Duplicar cria outro template a partir de uma versão ou de um rascunho explicitamente identificado.

Publicar e escolher o alcance

A publicação retorna uma intenção durável, consultável em /template-publications/{publicationId}. O processamento envia o artefato imutável, confirma sua gravação e aplica os alvos solicitados com as revisões esperadas. Um retorno 202 não significa publicação concluída. Confira o estado geral e o resultado individual de cada alvo.

A escolha efetiva respeita a seleção do link, o padrão do domínio e o padrão do aplicativo, conforme o modo de herança. custom fixa template e versão; official usa o modelo oficial; inherit delega ao nível superior onde permitido. Não se utiliza um rascunho como configuração pública.

A disponibilidade de uma versão só aparece após a confirmação do artefato. Atualizar uma seleção também gera uma projeção para o redirecionador. A confirmação do dispatcher comprova o processamento naquele momento; o KV pode continuar propagando para outros pontos da rede.

Restaurar e repetir

A restauração cria outra intenção de publicação, com alvos e revisões explícitos, para retornar a uma versão ou ao modelo oficial. O snapshot antigo permanece intacto. Uma mudança concorrente em um alvo pode gerar conflito; examine o resultado antes de tentar novamente.

Use retry para retomar uma publicação elegível depois de consultar sua revisão. Preserve a mesma chave de idempotência ao repetir a mesma requisição após timeout; uma nova intenção exige uma nova chave. Revogar a autorização impede a publicação e a ativação ainda pendentes, mas não desfaz uma configuração já aplicada.

Veja sequência e concorrência na API e os 45 endpoints deste marco.