Borradores

En un modelo con la publicación activada, un guardado añade una versión en borrador y la API sigue devolviendo la publicada. Puedes ver el borrador tal como lo serviría la API antes de publicar.

Qué hace un guardado

Un registro nuevo empieza como versión 1, en borrador. Cada guardado añade una versión, y la API pública sigue devolviendo la versión publicada hasta que publiques una concreta por su id de versión. La publicación se activa por modelo. En un modelo sin ella, los cambios surten efecto de inmediato.

El panel de vista previa en el editor de registros

El editor de registros de la consola tiene un panel de vista previa. Construye la consulta GraphQL del registro a partir del esquema vivo, la ejecuta contra la API pública y muestra la respuesta exacta. Un interruptor muestra la misma lectura como documento GraphQL o como llamada del SDK, y otro alterna entre el borrador guardado y la última versión publicada. El locale procede del selector de idioma del editor, y puedes establecer las dimensiones de contexto del proyecto y simular el estado de inicio de sesión y los segmentos.

Vista previa con una clave concreta

El panel puede ejecutarse como tu propia sesión de consola, como esa sesión limitada a ciertos alcances o como una clave pública que pegues. Tu propia sesión lee todos los campos, así que para ver lo que serviría una clave de API concreta, pega esa clave.

Leer borradores desde tu propia aplicación

Una consulta que pasa preview: true lee el último borrador, y su clave debe tener el drafts:read alcance. La configuración documentada es una clave pública aparte para el despliegue de vista previa que tenga el alcance, que la clave de producción no tiene. Una solicitud de vista previa desde una clave que no lo tiene se rechaza con un error de permiso. Las lecturas de borradores nunca se guardan en la caché de respuestas.

Lee el detalle

La guía de registros expone el flujo de borrador y publicación, con las mutaciones de GraphQL y los comandos de la CLI de cada paso.