L'application API Connector fonctionne en trois étapes simples 😉
- API Connector interroge l'API externe de votre choix (OpenAI, Bazaarvoice, votre PIM…)
- Les données récupérées sont automatiquement stockées dans DataStorage, structurées et associées à vos URLs
- Vous réutilisez ces données dans Recommandation SEO pour enrichir vos pages (FAQ, avis clients, résumés, contenu généré par IA…)
En résumé : une seule configuration → des données toujours à jour → des recommandations SEO automatisées.
Comment configurer un connecteur API ?
Étape 1 - Créer un secret
Avant de configurer un connecteur API, vous devez stocker vos clés API dans la section « Secrets ». Les secrets permettent de sécuriser vos clés d'authentification sans les exposer en clair.
- Accédez au module Secrets depuis la première étape de la configuration du connecteur API.
- Cliquez sur le lien « Ajouter un nouveau secret »
- Cliquez ensuite sur le bouton « Ajouter un nouveau secret »
- Renseignez le nom du secret : utilisez un nom court et explicite (ex. OpenAIKey, DeepLToken, BazaarvoiceAuth)
- Renseignez la valeur du secret : copiez-collez votre clé API fournie par le service externe
- Cliquez sur Créer
🔒 Les secrets sont chiffrés et ne sont jamais affichés en clair. Ils seront ensuite appelés dans vos en-têtes API sous la forme Authorization: Bearer NomDuSecret.
Étape 2 - Créer un nouveau connecteur
- Accédez à l'application API Connector depuis votre console EdgeSEO
- Cliquez sur le bouton nouveau connecteur
- Renseignez le nom du connecteur : choisissez un nom court et explicite pour identifier facilement le connecteur (ex. "Avis produits", "Traduction titres", "FAQ générée")
- Ajoutez une description : indiquez l'objectif du connecteur pour faciliter la compréhension par votre équipe (ex. "Récupère les avis clients depuis Bazaarvoice pour les afficher sur les fiches produits")
- Cliquez sur suivant
Étape 3 - Définir les variables dynamiques (optionnel)
Cette étape est optionnelle. Elle permet de récupérer des éléments de la page (texte, attributs HTML, code HTML) pour les envoyer dans votre requête API.
Le fonctionnement est identique aux variables dans l'application Recommandation SEO.
Vous pouvez par exemple extraire le contenu d'une balise H1, d'une classe CSS spécifique, ou d'un attribut de données pour l'utiliser dans votre appel API.
- Cliquez sur Ajouter une variable si vous souhaitez en créer une
- Renseignez le nom de la variable (ex. "mavariable")
- Indiquez le sélecteur CSS (ex. "h1.classCss")
- Choisissez le type d'élément à extraire (Texte, HTML…)
- Cliquez sur suivant
Étape 4 - Définir la cible de déclenchement
Cette étape détermine où et quand la requête API sera exécutée sur votre site.
Le fonctionnement est identique aux cibles dans l'application Recommandation SEO. Vous pouvez cibler des URLs spécifiques, des types de pages, ou utiliser des expressions régulières.
- Cliquez sur Créer ma première cible
- Configurez votre cible selon vos besoins (URL égale à, contient, expression régulière…)
Étape 5 - Configurer la requête API
C'est l'étape centrale où vous paramétrez l'appel à votre API externe.
- Choisissez la méthode HTTP pour votre requête (POST, GET…)
- Configurer l'endpoint : renseignez l'URL complète de l'API à interroger (ex. https://api.openai.com/v1/chat/completions)
- Définir les en-têtes (headers) : ajoutez les en-têtes nécessaires pour votre requête
- Cliquez sur le champ pour ajouter un en-tête
- Nom de l'en-tête (ex. Content-Type, Authorization)
- Valeur de l'en-tête (ex. application/json, Bearer NomDuSecret)
- Pour utiliser un secret, référencez-le directement dans la valeur (ex. Bearer OpenAIKey)
- Définir le body (corps de la requête) : renseignez le contenu JSON de votre requête
- Vous pouvez utiliser les variables dynamiques créées précédemment en cliquant dans le champ
- Exemple : {"model":"gpt-4o-mini","messages":[{"role":"user","content":"Reformule ce titre : {{h1}} pour black friday"}]}
- Définir le TTL (durée de validité) :
- Sélectionnez une durée en secondes pendant laquelle la donnée sera considérée comme valide avant une nouvelle requête
- Adaptez cette valeur selon la fréquence de mise à jour de vos données
- Renseignez une valeur test et cliquez sur le bouton Tester pour valider que requête fonctionne
- Mapper la réponse : associez les champs de la réponse API à des clés personnalisées pour faciliter leur utilisation dans DataStorage
- Clé personnalisée (ex. "faq", "model")
- Sélectionnez le chemin de réponse de l'API en cliquant dans le champ
- Cliquez sur enregistrer
Les données reçues sont automatiquement stockées dans DataStorage et associées à l'URL où la requête a été déclenchée. Un dataset est créé automatiquement pour chaque connecteur.
Étape 6 - Utiliser les données dans Recommandation SEO
Une fois votre connecteur configuré et actif, les données sont disponibles dans DataStorage. Vous pouvez les réutiliser dans vos recettes Recommandation SEO.
- Accédez à l'application Recommandation SEO
- Créez ou modifiez une recette
- Séléctionnez les variables que vous souhaitez utiliser selon le mapping que vous avez défini
- Exemple : si vous avez mappé la variable « faq », utilisez directement cette variable
Les données sont maintenant exploitables dans vos recommandations SEO pour enrichir automatiquement vos pages.
