Une clé API permet à votre site web de se connecter à InnoBooks. Vous créez la clé en la nommant, vous copiez la
Clé APIet leSecret(le secret n’est affiché qu’une seule fois), puis vous les collez dans la configuration de votre site. Vous pouvez ensuite régénérer, désactiver ou supprimer la clé. Voici la marche à suivre.
Ce dont vous avez besoin #
- La permission d’accéder aux paramètres, et le droit de gérer les clés (créer, régénérer, supprimer).
- Un site web à connecter, avec un endroit où saisir une clé et un secret d’API.
Étapes #
- Ouvrir la page des clés API
Dans le menu, ouvrez les
Paramètres, puis la pageClés API sites web. Son sous-titre précise : « Clés permettant à vos sites web de se connecter à InnoBook (API). » Les clés existantes s’affichent dans un tableau ; s’il n’y en a aucune, un message invite à en créer une.
La page Clés API sites web avec le tableau des clés. - Créer une clé
Dans l’encadré de création, saisissez un
Nomreconnaissable (par exemple le nom du site), puis cliquez surCréer une clé. - Copier la Clé API et le Secret
Un encadré s’affiche avec l’avertissement
C'est le seul moment où le secret est affiché. Copiez-le maintenant.Copiez laClé APIet leSecretà l’aide du boutonCopier, puis cliquez surTerminé. - Coller les valeurs dans votre site web
Suivez l’indication affichée : collez la
Clé APIet leSecretdans la configuration de votre site (Configuration du site → InnoBook API Key / API Secret). - Gérer vos clés (Facultatif)
Dans le tableau, chaque clé affiche son
Nom, saClé API, sonStatut(basculeActive/Désactivée) et sa dateCréée le. UtilisezRégénérer le secretpour produire un nouveau secret, ouSupprimerpour retirer la clé.
Astuces & cas particuliers #
- Le
Secretn’est affiché qu’une seule fois, à la création ou à la régénération : copiez-le immédiatement et conservez-le en lieu sûr. - Secret perdu ou compromis ? Cliquez sur
Régénérer le secret: un nouveau secret est généré et l’ancien cesse immédiatement de fonctionner. - Pour couper temporairement l’accès d’un site sans supprimer la clé, basculez le
StatutsurDésactivée. - La suppression est irréversible : le site qui utilise la clé ne pourra plus se connecter.
Questions fréquentes #
Que faire si j’ai perdu le secret d’une clé ? #
Cliquez sur Régénérer le secret sur la ligne de la clé. Un nouveau secret est généré et affiché une seule fois ; l’ancien cesse immédiatement de fonctionner. Copiez le nouveau et mettez à jour votre site.
Où coller la Clé API et le Secret ? #
Dans la configuration de votre site web, aux champs prévus (Configuration du site → InnoBook API Key / API Secret), comme le rappelle l’encadré après la création.
Comment désactiver temporairement une clé ? #
Dans la colonne Statut, basculez la clé sur Désactivée. Le site ne pourra plus se connecter tant que vous ne la remettez pas Active, sans avoir à la supprimer.
Que se passe-t-il si je supprime une clé ? #
Le site web qui utilise cette clé ne pourra plus se connecter. L’action est irréversible ; créez plutôt une nouvelle clé si vous devez remplacer l’ancienne.
