Générer et gérer des clés API, et autoriser une connexion OAuth

Avanzado8 minVerificada el 3/11/2026Aún sin traducir

Lo que tendrá: Votre intégrateur ou votre outil d'automatisation accède à vos données Genuka avec une clé que vous contrôlez.

Les autres logiciels de l'entreprise lisent et écrivent dans Genuka sans partage de mot de passe, et l'accès se coupe en un clic.

Antes de empezar

Pantallas mostradas para:

Pourquoi c'est utile

Un prestataire qui relie votre site, votre logiciel de livraison ou un outil comme n8n à Genuka a besoin d'un accès. Lui donner votre mot de passe est risqué. Une clé API lui donne un accès dédié, que vous nommez, datez et supprimez quand vous voulez. Pour les applications plus grand public, la connexion « avec Genuka » (OAuth) vous demande simplement d'autoriser l'accès.

Résumé

  • Clé API : se crée dans Paramètres › Intégrations › Clés d'API. Elle agit au nom du membre qui l'a créée, avec ses droits.
  • Connexion OAuth : quand une application vous demande de vous connecter avec Genuka, un écran Genuka vous montre ce qu'elle pourra voir, et vous choisissez Autoriser ou Refuser.

Prérequis

  • Pour la carte Clés d'API des paramètres : la permission users.*. Lister les clés demande d'être administrateur ou gérant, ou d'avoir api_keys.view.
  • Pour autoriser une connexion OAuth : être administrateur de l'entreprise et avoir une adresse e-mail vérifiée.

Étapes : créer une clé API

  1. Ouvrez Paramètres › Intégrations › Clés d'API (page Clés API).
  2. Cliquez sur Générer une clé API.
  3. Renseignez le Nom (à quoi sert la clé, ex. « Site e-commerce »), une Description et la date Expire le (un mois plus tard par défaut).
  4. Cliquez sur Créer. La clé apparaît dans la liste, masquée sauf ses premiers et derniers caractères, avec un badge actif ou expiré.
  5. Cliquez sur Copier et transmettez la clé à votre intégrateur par un canal sûr.

L'intégrateur l'envoie dans l'en-tête X-API-Key de chaque appel, avec l'identifiant de votre entreprise dans l'en-tête X-Company. La documentation de l'API décrit le reste.

Étapes : autoriser une application par OAuth

  1. Depuis l'application, choisissez la connexion avec Genuka. Un écran Genuka s'ouvre : « … veut accéder à votre compte Genuka ».
  2. Vérifiez le compte affiché (Connecté en tant que) et choisissez l'Espace de travail (l'entreprise) auquel l'application accédera.
  3. Lisez Ce que l'application pourra voir : vérification d'identité, profil, adresse e-mail, et/ou les informations et données de l'entreprise choisie.
  4. Cliquez sur Autoriser, ou sur Refuser.

C'est aussi ce chemin qu'utilisent les assistants IA comme Claude pour se connecter à votre compte (voir « Connecter un assistant IA par MCP »).

Champs & options

ÉlémentRôle
Nom, DescriptionPour retrouver à quoi sert chaque clé.
Expire leAprès cette date, la clé est refusée. Sans date, la clé vaut un an.
CopierCopie la clé complète.
SupprimerCoupe l'accès immédiatement.

Cas limites & erreurs fréquentes

  • La clé a les droits de son créateur. Si vous la créez avec un compte administrateur, l'intégration peut tout faire. Pour limiter l'accès, créez la clé depuis un compte membre dont le rôle n'a que les droits nécessaires.
  • La clé ne marche plus du jour au lendemain. Elle a expiré (badge expiré dans la liste), ou son créateur a quitté l'entreprise. Créez-en une nouvelle.
  • Une clé copiée reste copiable. Toute personne qui a accès à la page des clés peut la copier à nouveau. Supprimez et recréez une clé qui a pu fuiter.
  • « Vérifiez votre adresse e-mail ». Seuls les comptes vérifiés peuvent autoriser une application. Vérifiez votre e-mail puis revenez sur la demande.
  • « Vous n'êtes administrateur d'aucun espace ». Seul un administrateur peut autoriser une application ; demandez-lui de le faire.
  • Retirer une autorisation OAuth. Le tableau de bord n'a pas encore d'écran qui liste les applications autorisées par OAuth. Pour une application de l'App Store, désinstallez-la ; sinon, contactez le support.
  • Certains libellés s'affichent en anglais sur la page des clés (colonne d'expiration, badges, messages de confirmation).

FAQ

Clé API ou application ? Une application de l'App Store s'installe en un clic et gère sa propre connexion. Une clé API sert à une intégration sur mesure ou à un outil d'automatisation que vous configurez vous-même.

Combien de clés puis-je créer ? Autant que nécessaire. Une clé par intégration permet de couper un accès sans gêner les autres.

Puis-je recevoir les événements sans interroger l'API ? Oui, avec un webhook (voir « Configurer un webhook »).

Voir aussi

  • Configurer un webhook
  • Installer et gérer une application
  • Connecter un assistant IA par MCP
  • Créer un rôle et gérer les permissions

Inicie sesión para guardar las lecciones terminadas.

Abrir en Genuka
¿Una pregunta sobre esta lección?Preguntar al asistenteResponde a partir de las lecciones y le muestra dónde mirar.