> For the complete documentation index, see [llms.txt](https://documentation.tousquali.fr/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://documentation.tousquali.fr/integrations/02-cle-api.md).

# 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

1. Connecte-toi à TousQuali
2. Va dans **Paramètres** (menu de gauche)
3. 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 :

1. Clique sur le bouton **"Générer ma clé API"**
2. 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 :

| Information                    | Valeur                            |
| ------------------------------ | --------------------------------- |
| **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 :

1. Va dans **Paramètres** > **Intégrations**
2. Clique sur **"Régénérer ma clé API"**
3. 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 :

```
GET https://app.tousquali.fr/api/v1/me
```

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.