Rascunhos

Em um modelo com a publicação ativada, um salvamento adiciona uma versão de rascunho e a API continua retornando a publicada. Você pode ver o rascunho como a API o serviria antes de publicar.

O que um salvamento faz

Um registro novo começa como versão 1, em rascunho. Cada salvamento adiciona uma versão, e a API pública continua retornando a versão publicada até que você publique uma versão específica pelo id dela. A publicação é ativada por modelo. Em um modelo sem ela, as alterações entram em vigor imediatamente.

O painel de preview no editor de registros

O editor de registros no console tem um painel de preview. Ele monta a consulta GraphQL do registro a partir do schema ao vivo, executa contra a API pública e mostra a resposta exata. Um alternador mostra a mesma leitura como um documento GraphQL ou como a chamada do SDK, e uma chave faz a troca entre o rascunho salvo e a última versão publicada. O locale vem do seletor de idioma do editor, e você pode definir as dimensões de contexto do projeto e simular o status de login e os segmentos.

Visualizando como uma chave específica

O painel pode rodar como a sua própria sessão do console, como essa sessão restrita a escopos escolhidos, ou como uma chave pública que você cola. A sua própria sessão lê todos os campos, então, para ver o que uma chave de API receberia, cole essa chave.

Lendo rascunhos a partir da sua própria aplicação

Uma consulta que passa preview: true lê o rascunho mais recente, e o escopo drafts:read é exigido da chave dela. A configuração documentada é uma chave pública separada para a implantação de preview que tenha o escopo, e que a chave de produção não tem. Uma requisição de preview de uma chave sem ele é recusada com um erro de permissão. As leituras de rascunho nunca são armazenadas no cache de respostas.

Leia os detalhes

O guia de registros descreve o fluxo de rascunho e publicação, com as mutations GraphQL e os comandos da CLI de cada etapa.