Si vous ne connaissez pas GraphQL, il serait préférable de suivre la documentation officielle.

Authentification

Avant de pouvoir accéder à l'API, veuillez suivre les instructions pour obtenir un TOKEN, ici.

Documentation technique

Les requêtes GraphQL sont envoyées au serveur via la méthode POST à l'adresse suivante : https://robertveutlire.com/graphql

Formatage des paramètres

Pour traiter la demande, notre API s'attend à recevoir un objet JSON. Conformément à la spécification, cet objet doit contenir les champs suivants :

{
  "query": "...",
  "operationName": "...",
  "variables": null
}

Exemple : Pour une requête GraphQL comme celle-ci :

{
  suggerer_livres(id: "7c02dcf9-ca51-4f81-a04b-fae96c8cc34c") {
    id
    titre
    ean13
  }
}

Les POSTdata devront être formatées comme ceci :

{
  "query": "{ suggerer_livres(id: \"7c02dcf9-ca51-4f81-a04b-fae96c8cc34c\") { id titre ean13 } }",
  "operationName": null,
  "variables": null
}

Si vous utilisez Node, nous vous recommandons des outils comme apollo, qui vous faciliteront la tâche de ces opérations.

Exemple complet

En copiant cette ligne de code dans votre terminal (⚠️ n'oubliez pas de remplacer TOKEN par votre TOKEN personnel)

curl -H "Content-Type: application/json" -H "Authorization: Bearer TOKEN" -X POST https://robertveutlire.com/graphql -d '{ "query": "query { suggerer_livres(id: "7c02dcf9-ca51-4f81-a04b-fae96c8cc34c") { id titre ean13 } }","variables":null}'