Bozze

Su un modello con la pubblicazione attiva, un salvataggio aggiunge una versione in bozza e l'API continua a restituire quella pubblicata. Puoi vedere la bozza come la servirebbe l'API prima di pubblicare.

Cosa fa un salvataggio

Un nuovo record parte come versione 1, in bozza. Ogni salvataggio aggiunge una versione, e l'API pubblica continua a restituire la versione pubblicata finché non ne pubblichi una specifica con il suo id di versione. La pubblicazione è attivata per modello. Su un modello che non ce l'ha, le modifiche hanno effetto subito.

Il pannello di anteprima nell'editor dei record

L'editor dei record nella console ha un pannello di anteprima. Costruisce la query GraphQL del record dallo schema attuale, la esegue sull'API pubblica e mostra la risposta esatta. Un selettore mostra la stessa lettura come documento GraphQL o come chiamata SDK, e un interruttore passa dalla bozza salvata all'ultima versione pubblicata. Il locale viene dal selettore della lingua dell'editor, e puoi impostare le dimensioni di contesto del progetto e simulare lo stato di login e i segmenti.

Anteprima come una chiave particolare

Il pannello può girare come la tua sessione della console, come quella sessione ristretta a scope scelti, o come una chiave pubblica che incolli. La tua sessione legge ogni campo, quindi per vedere cosa servirebbe una certa chiave API incolla quella chiave.

Leggere le bozze dalla tua applicazione

Una query che passa preview: true legge l'ultima bozza, e la sua chiave deve avere drafts:read come scope. La configurazione documentata è una chiave pubblica separata per il deployment di anteprima che ha lo scope, e che la chiave di produzione non ha. Una richiesta di anteprima da una chiave che non lo ha viene rifiutata con un errore di permesso. Le letture delle bozze non vengono mai salvate nella cache delle risposte.

Leggi il dettaglio

La guida ai record descrive il flusso di bozza e pubblicazione, con le mutation GraphQL e i comandi della CLI per ogni passaggio.