Générer ta clé API
Vue d'ensemble
Ta clé API est ton identifiant personnel pour connecter TousQuali à tes autres outils. C'est comme un mot de passe spécial réservé aux intégrations.
🔑 Une clé unique par organisme
🔒 Accès limité à tes données uniquement
🔄 Régénérable à tout moment si besoin
Étape 1 : Accède aux paramètres d'intégrations
Connecte-toi à TousQuali
Va dans Paramètres (menu de gauche)
Clique sur Intégrations
Tu arrives sur la page dédiée aux intégrations de ton organisme.
Étape 2 : Génère ta clé API
Si c'est la première fois :
Clique sur le bouton "Générer ma clé API"
Ta clé s'affiche à l'écran
⚠️ Important : Copie ta clé et conserve-la dans un endroit sûr. Elle ne sera plus affichée en entier par la suite pour des raisons de sécurité.
Étape 3 : Utilise ta clé
Pour connecter TousQuali à un outil externe, tu auras besoin de :
URL de l'API
https://app.tousquali.fr/api/v1
Clé API
La clé que tu viens de générer
En-tête d'authentification
X-API-KEY
Concrètement, chaque requête vers l'API doit inclure ta clé dans l'en-tête X-API-KEY.
💡 Sur Zapier, tu n'as pas besoin de te soucier des détails techniques. Il suffit de coller ta clé API dans le champ prévu lors de la configuration de la connexion.
Régénérer ta clé API
Si tu penses que ta clé a été compromise ou si tu souhaites simplement en créer une nouvelle :
Va dans Paramètres > Intégrations
Clique sur "Régénérer ma clé API"
Confirme l'action
⚠️ Attention : Régénérer ta clé désactive immédiatement l'ancienne. Toutes tes intégrations existantes cesseront de fonctionner tant que tu n'auras pas mis à jour la nouvelle clé dans chaque outil connecté.
Vérifier ta connexion
Tu peux tester que ta clé fonctionne en accédant à l'endpoint de vérification :
Si ta clé est valide, tu recevras les informations de ton organisme (nom, abonnement, administrateur·ice).
Bonnes pratiques de sécurité
🔒 Ne partage jamais ta clé API publiquement (forums, emails non sécurisés, réseaux sociaux)
🔄 Régénère ta clé si tu penses qu'elle a été exposée
👥 Limite l'accès : seul·e l'administrateur·ice du compte peut générer ou régénérer la clé
📋 Note où tu l'utilises : garde une trace des outils dans lesquels tu as configuré ta clé, pour pouvoir les mettre à jour si nécessaire
Questions fréquentes
Q : Ma clé API a-t-elle une date d'expiration ? R : Non, ta clé reste valide indéfiniment, sauf si tu la régénères manuellement.
Q : Puis-je avoir plusieurs clés API ? R : Non, chaque organisme dispose d'une seule clé API active à la fois. Si tu régénères ta clé, l'ancienne est automatiquement désactivée.
Q : Que se passe-t-il si quelqu'un utilise ma clé ? R : Cette personne pourrait consulter les données de ton organisme (formations, sessions, inscriptions). Elle ne pourrait pas les modifier. Si tu suspectes un usage non autorisé, régénère immédiatement ta clé.
Q : Où trouver la documentation technique complète de l'API ? R : La documentation interactive (Swagger) est accessible à l'adresse https://app.tousquali.fr/api/v1/docs. Elle liste tous les endpoints, paramètres et formats de réponse.
Mis à jour