Créer la connexion
Une connexion relie une application à un commerce. C'est le commerçant qui la crée, depuis un compte administrateur de son espace ; il n'y a ni code d'appairage, ni adresse de rappel, ni jeton à échanger.
Côté Kult Lab
Ouvrir le module API
Dans le commerce concerné, onglet Intégrations, le module API.
Nommer l'application et choisir son type
Le nom est celui que le commerçant lira partout dans Kult Lab ; votre application ne le modifie jamais. Le type (boutique en ligne, caisse, autre application) est remplacé par celui que votre application déclare à son premier bonjour.
Créer les clés
Kult Lab affiche deux valeurs, une seule fois :
| Variable | Contenu |
|---|---|
KULTLAB_API_KEY | la clé, kl_<préfixe>.<secret>, envoyée en Authorization: Bearer |
KULTLAB_SIGNING_SECRET | le secret qui signe chaque requête et chaque réponse, dans les deux sens |
Les deux valeurs n'existent nulle part ailleurs : Kult Lab ne garde que leur empreinte. Une valeur perdue avant d'être copiée se remplace par Annuler la connexion puis une nouvelle création, ou par un renouvellement une fois la connexion établie.
Côté application
Rangez les deux valeurs dans l'environnement de l'application, hors de son dépôt :
KULTLAB_API_KEY=kl_ab12cd34.xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
KULTLAB_SIGNING_SECRET=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
KULTLAB_BASE_URL=https://kult-lab.com/api/v1/channel
Une connexion par commerce et par application : une application servant trois commerces reçoit trois paires de valeurs, et sait laquelle utiliser pour chaque commerce.
Prochaine étape : dire bonjour.