Créer une story

Créer une story tient en une mutation, storyPost. Comme son entrée est longue, séparez la requête en deux parties : la mutation et les variables.

La mutation :

mutation storyPostExample($input: StoryPostInput!) {
  storyPost(input: $input) {
    story {
      id
      slug
      version {
        title
      }
    }
    errors {
      __typename
      ... on MutationError {
        path
      }
    }
  }
}

Les variables :

{
  "input": {
    "publish": true,
    "spaceId": "SPACE_ID",
    "title": "My first story",
    "body": {
      "format": "MARKDOWN",
      "markup": "# Hello world\n\nThis story was created through the API."
    }
  }
}

Les champs que vous utiliserez le plus :

• spaceId est l’identifiant GraphQL de l’espace. Si vous n’avez que son slug, récupérez l’identifiant avec space(slug:) { id }, comme le fait Lire une story pour une story. Mettez-le à null pour créer la story dans le contenu personnel de l’utilisateur.
• body.format est l’un des formats de corps : MARKDOWN pour du Markdown simple, MARKDOWN_ELIUM pour du Markdown avec les directives Elium, HTML ou HTML_ELIUM pour du HTML.
• publish vaut false par défaut : la story reste un brouillon. Mettez-le à true pour la publier.
• schemaId applique un modèle. tags et hashtags attendent des listes d’identifiants. lang définit la langue de la version.

La réponse :

{
  "data": {
    "storyPost": {
      "story": {
        "id": "U3Rvcnk6MTIz",
        "slug": 123,
        "version": {
          "title": "My first story"
        }
      },
      "errors": null
    }
  }
}

Pour joindre un fichier à la nouvelle story, consultez Créer une story avec un fichier.