Comment utiliser l'API?

L'API de suggestion consiste en deux parties :

• Trouver un livre;
• Demander des suggestions pour ce livre;

Nous utiliserons dans les exemples ci-dessous la syntaxe GraphQL. Pour savoir en détail comment envoyer des requêtes à l'API, veuillez consulter la documentation technique ici.

1. Trouver un livre

L'API de recherche de livres vous permettra de rechercher un ouvrage par le titre. La réponse vous donnera un id qui vous servira lors de la deuxième étape pour demander des suggestions.

Note : Comme un même livre peut avoir plusieurs numéro ISBN, la réponse est un Array de livres.

Exemple : Query GraphQL

{
  trouver_livres(data: "mousquetaire") {
    id
    titre
    ean13
  }
}

Réponse JSON

{
  "data": {
    "trouver_livres": [
      {
        "id": "7e2a22f1-9699-4abf-aaed-414c4ae04d43",
        "titre": null,
        "ean13": "9780471176695"
      },
    ]
  }
}

2. Demander des suggestions

Ici, on utilise l'id récupéré à l'étape précédente afin de demander des suggestions.

Exemple : Query GraphQL

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

Réponse JSON

{
  "data": {
    "suggerer_livres": [
      {
        "id": "00002605-4e70-4280-934f-5c078f81b560",
        "titre": "La mer, comment ça marche ?",
        "ean13": "9782603019245"
      },
      {
        "id": "00006fa2-56e8-447b-af7e-003b0dad917c",
        "titre": "Les grandes vacances",
        "ean13": "9782746708433"
      },
      {
        "id": "0000c981-88ca-4e69-90bf-9479f59aef7c",
        "titre": "Ibicus",
        "ean13": "9782749303420"
      },
      {
        "id": "0000d7dd-4c32-488d-8163-07be9d9021fc",
        "titre": "Je dessine des centaines d'auto",
        "ean13": "9782920564176"
      },
      {
        "id": "00019c36-88fa-4d73-8a8f-eb0dc144c6d6",
        "titre": "Comment pardonner?",
        "ean13": "9782896467174"
      },
      {
        "id": "0001c819-3c7d-43b5-9a55-0866612f59ca",
        "titre": "Le garçon aux yeux gris",
        "ean13": "9782213608693"
      }
    ]
  }
}