Créer une clé
Crée une clé API dans l'app : son nom, ses périmètres, les conditions d'usage, et la seule fois où tu peux la copier.
Une clé est le mot de passe d'un outil. Tu en crées une par outil, avec seulement les droits dont il a besoin. Tout se passe dans l'app.
1. Ouvre la page Clés API
Dans l'app, va dans Paramètres › Intégrations › Clés API. Clique sur Nouvelle clé, ou sur Créer ma première clé si la liste est vide. Si ton offre n'ouvre pas l'API, la page te l'explique à la place de la liste.
2. Donne un nom à la clé
Prends le nom de l'outil qui va l'utiliser, par exemple « Synchro nocturne ». Le nom sert à la reconnaître dans la liste et dans le Journal des appels.
3. Choisis ce que la clé peut faire
Tu coches des périmètres, regroupés par famille de données : Élèves, Entraînement, Bilans, Habitudes et les autres. Chaque famille propose jusqu'à trois cases : Lire, Écrire et Supprimer. Cocher Supprimer coche Écrire pour toi. Au départ, Lire est coché sur Élèves, Entraînement, Bilans et Habitudes.
Le bas de la fenêtre affiche le mode de la clé. C'est une étiquette qui suit la permission la plus forte que tu as cochée :
| Mode | Affiché quand |
|---|---|
| Lecture | tu n'as coché que des cases Lire |
| Écriture | au moins une case Écrire est cochée, et aucune case Supprimer |
| Complet | au moins une case Supprimer est cochée |
Le mode n'ajoute aucun accès en lecture. Une clé qui n'a que Écrire sur Élèves affiche Écriture et ne peut pas lire les élèves : coche aussi Lire quand l'outil doit lire.
Plus bas, la rubrique Données sensibles regroupe les coordonnées des élèves, les réponses aux formulaires, la santé du bilan initial et les médias. N'y coche que ce dont l'outil a vraiment besoin. Sans Coordonnées des élèves, l'email et le phone d'un élève sont absents des réponses.
4. Accepte les conditions d'usage
Une étape Conditions apparaît avant ta toute première clé. Elle apparaît aussi avant une clé en écriture, si tu n'as pas encore accepté la version en vigueur. Retiens trois points :
- une clé en écriture agit en ton nom auprès de tes élèves ;
- tu restes responsable des outils que tu branches ;
- les appels sont journalisés (clé, route, date, statut), et tu les retrouves dans le Journal des appels.
Le journal liste les appels qui arrivent à l'étape des crédits. GET /me et les refus qui tombent avant, comme un 401, un 403 ou un 429, n'y laissent pas de ligne.
Coche la case d'acceptation pour continuer.
5. Copie la clé
Clique sur Créer la clé. Une fenêtre affiche la clé complète, qui commence par fd_live_. Copie-la avec le bouton Copier et colle-la dans ton outil. La fenêtre propose aussi un premier appel gratuit, que tu retrouves dans Premier appel.
La clé ne s'affiche qu'une fois
Fit'Distance ne stocke pas la clé complète : une fois la fenêtre fermée, elle ne s'affiche plus jamais. Traite-la comme un mot de passe. Ne la mets ni dans une application côté client, ni dans un dépôt public. Si tu la perds, révoque-la et crée-en une nouvelle.
Cinq clés actives au plus
Tu peux avoir cinq clés actives en même temps. Pour en créer une sixième, révoque d'abord une des cinq : l'app te le demande. Les clés révoquées ne comptent plus.
Renommer, révoquer, changer les périmètres
- Renommer : le nom se change dans la liste, la clé reste la même.
- Révoquer : une clé révoquée cesse de fonctionner, et ses appels reçoivent un 401.
- Changer les périmètres : on ne modifie pas une clé. Crée-en une nouvelle avec les bons périmètres, mets-la dans ton outil, puis révoque l'ancienne.
Si un appel reçoit un 403 SCOPE_MISSING, details.scope nomme le périmètre qui manque : c'est celui à cocher sur la nouvelle clé.