Brouillons
Sur un modèle où la publication est activée, une sauvegarde ajoute une version brouillon et l'API continue de renvoyer la version publiée. Vous pouvez voir le brouillon tel que l'API le servirait avant de publier.
Ce que fait une sauvegarde
Un nouvel enregistrement commence à la version 1, en brouillon. Chaque sauvegarde ajoute une version, et l'API publique continue de renvoyer la version publiée jusqu'à ce que vous en publiiez une précise par son id de version. La publication est activée par modèle. Sur un modèle sans publication, les changements prennent effet immédiatement.
Le volet d'aperçu dans l'éditeur d'enregistrement
L'éditeur d'enregistrement de la console a un volet d'aperçu. Il construit la requête GraphQL de l'enregistrement à partir du schéma en cours, l'exécute sur l'API publique et affiche la réponse exacte. Un bouton bascule affiche la même lecture sous forme de document GraphQL ou d'appel SDK, et un commutateur passe du brouillon sauvegardé à la dernière version publiée. La locale vient du sélecteur de langue de l'éditeur, et vous pouvez définir les dimensions de contexte du projet et simuler l'état de connexion et les segments.
Prévisualiser avec une clé donnée
Le volet peut s'exécuter avec votre propre session de console, avec cette session restreinte à des portées choisies, ou avec une clé publique que vous collez. Votre propre session lit tous les champs ; pour voir ce que servirait une clé API donnée, collez cette clé.
Lire les brouillons depuis votre application
Une requête qui passe preview: true lit le dernier brouillon, et sa clé doit détenir la portée drafts:read ; la configuration documentée est une clé publique distincte pour le déploiement de prévisualisation, qui détient la portée, ce que la clé de production n'a pas. Une requête de prévisualisation faite avec une clé qui ne l'a pas est refusée avec une erreur de permission. Les lectures de brouillons ne sont jamais stockées dans le cache de réponses.
Lire le détail
Le guide des enregistrements détaille le flux brouillon et publication, avec les mutations GraphQL et les commandes CLI de chaque étape.