Générer des clés API pour vos sites web

Une clé API permet à votre site web de se connecter à InnoBooks. Vous créez la clé en la nommant, vous copiez la Clé API et le Secret (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 #

1. Ouvrir la page des clés API

   Dans le menu, ouvrez les Paramètres, puis la page Clé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.

   

2. Créer une clé

   Dans l’encadré de création, saisissez un Nom reconnaissable (par exemple le nom du site), puis cliquez sur Créer une clé.

3. 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 la Clé API et le Secret à l’aide du bouton Copier, puis cliquez sur Terminé.

4. Coller les valeurs dans votre site web

   Suivez l’indication affichée : collez la Clé API et le Secret dans la configuration de votre site (Configuration du site → InnoBook API Key / API Secret).

5. Gérer vos clés (Facultatif)

   Dans le tableau, chaque clé affiche son Nom, sa Clé API, son Statut (bascule Active / Désactivée) et sa date Créée le. Utilisez Régénérer le secret pour produire un nouveau secret, ou Supprimer pour retirer la clé.

Astuces & cas particuliers #

• Le Secret n’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 Statut sur Dé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.

Articles liés #

• Connecter votre compte Stripe
• Envoyer des notifications push à vos clients