Connecteur API-JSON

Prérequis

une API qui retourne un JSON au format :

[
  {
    "title": "mon titre",
    "content": "mon content",
    {...},
    [...]
  },
  {
    "title": "mon titre 2",
    "content": "mon content 2",
    {...},
    [...]
  }
]

ou

[
  {

    "info": [
      { 
	      "title": "mon titre",
        "content": "mon content"
      }
    ]
  },
  ...
  ]

FAQ

Comment configurer mon connecteur ?

Une URL des URLs d’une API qui retourne du JSON avec des tableaux sur lesquels on peut boucler.

Exemple de retour d’API :

[
  {
    "title": "mon titre",
    "content": "mon content",
    {...},
    [...]
  },
  {
    "title": "mon titre 2",
    "content": "mon content 2",
    {...},
    [...]
  }
]

Grâce au template Mustache on peut construire notre futur document.

Exemple de template simple :

mon titre :  {{{title}}}
contenu de la page : {{{content}}}
description : {{{xxxx.xxxx.description}}}

On peut aussi cibler un tableau dans une réponse d’API.

Exemple : je veux récupérer les paragraphes dans le retour suivant :

[
  {
    "title": "mon-titre",
    "content": "mon content",
    {...},
    "paragraphes"[...]
  },
  {
    "title": "mon-titre-2",
    "content": "mon content 2",
    {...},
    "paragraphes"[...]
  }
]

Je peux mettre dans le champ chemin du tableau cible : paragraphes Le connecteur va créer un document par paragraphes.

Pour l’URL de la source, même fonctionnement que pour le template, on peut utiliser des {{{}}}

exemple :

https://monSite.com/{{{tite}}}
//https://monSite.com/mon-titre

Pour aller plus loin dans les templates Mustache ⇒ https://mustache.github.io/mustache.5.html