Comprendre les sources de données externes

Une collection Communik contient les fiches que vous gérez dans le CMS du site. Une source externe permet au site de demander des données à un autre service, par exemple une API.

Ces deux approches peuvent coexister. Le choix dépend surtout de l’endroit où les contenus doivent être gérés au quotidien.

1. Repérer les sources dans Données

Ouvrez Données dans la barre du builder. Le menu latéral distingue vos collections CMS des connexions externes proposées sur votre projet.

Dans la démonstration, Les rendez-vous Alma est une collection du site. REST API est la section destinée aux connexions vers un service extérieur.

Les types de sources affichés dépendent des composants disponibles dans votre projet. Cet article montre l’entrée REST API ; il ne certifie pas une connexion Airtable, Notion ou un autre service tiers.

2. Ouvrir l’ajout d’une connexion

Cliquez sur le + à côté de REST API. Le formulaire demande un nom pour reconnaître la connexion. Choisissez un nom parlant, comme Catalogue du partenaire, plutôt que API 1.

La création d’une entrée est le début de la configuration. Pour utiliser les données, il faut ensuite renseigner le service, les accès requis et les requêtes nécessaires. Une entrée visible dans le menu ne prouve pas que la connexion fonctionne.

La démonstration ouvre ce formulaire sans créer de connexion et sans saisir d’identifiants. Elle vous permet de repérer les commandes avant de disposer des informations du service.

3. Choisir entre import et connexion

Un import de contenus ajoute des fiches au CMS. Une connexion externe sert à demander des données au service configuré. Elle ne transforme pas automatiquement ces données en fiches d’une collection Communik.

4. Préparer les informations nécessaires

Avant de configurer la connexion, identifiez le service qui fournit les données, les accès autorisés et les données que le site doit afficher. Pour une API, demandez également l’adresse de la requête et un exemple de réponse.

Commencez avec un résultat simple, comme un titre et une description. Vérifiez la réponse avant de construire une mise en page complète. Vous pourrez ensuite associer les données à vos éléments, comme vous le faites avec une valeur dynamique.

5. Vérifier les limites réelles

Contrôlez séparément la lecture des données et leur modification. Le fait d’afficher une réponse ne prouve pas qu’une écriture vers le service extérieur est configurée ou autorisée.

Préparez aussi le cas où le service répond avec une liste vide, refuse l’accès ou ne répond pas. Le visiteur doit comprendre le résultat, sans rester devant un contenu incomplet.

Le rythme de mise à jour dépend de la requête, du service et de la configuration. Une connexion n’est pas une preuve de synchronisation immédiate dans les deux sens. Vérifiez un changement réel depuis le service jusqu’au site de test avant de promettre ce comportement.

Ce guide situe les connexions dans le builder et explique la différence avec les collections et les imports. Il ne valide aucune authentification externe, aucun quota, aucun transport REST ou GraphQL ni aucune opération d’écriture. Ces points demandent une configuration et une recette propres au service utilisé.