Brancher Zapier
Lis une page de tes élèves dans un zap avec Webhooks by Zapier et une requête personnalisée, ta clé dans l'en-tête Authorization.
Tu vas lire une page de tes élèves dans un zap, avec l'action Webhooks by Zapier › Custom Request : une adresse, une méthode et ta clé dans un en-tête.
Un zap lit une page par exécution
Il te faut une clé qui peut lire les élèves, avec Élèves › Lire (students:read) coché. Si tu n'en as pas, crée-la dans l'app, sous Paramètres › Intégrations › Clés API : elle ne s'affiche qu'une fois.
1. Choisis un déclencheur
Un zap commence par un déclencheur. Prends celui qui convient à ton usage : pour tester, une exécution planifiée suffit.
2. Ajoute l'action Custom Request
Ajoute l'action Webhooks by Zapier › Custom Request et remplis :
| Champ | Valeur |
|---|---|
| Method | GET |
| URL | https://api.fitdistance.io/api/partner/v1/students?limit=50 |
| Headers | Authorization : Bearer fd_live_xxxxxxxx |
limit=50 est dans l'adresse. Pour Headers, ajoute un en-tête nommé Authorization dont la valeur est Bearer fd_live_xxxxxxxx. Remplace fd_live_xxxxxxxx par ta clé, en gardant le mot Bearer, une espace, puis ta clé entière. Tu n'as pas besoin des autres champs. La clé est écrite dans l'action : ne partage pas ce zap avec quelqu'un qui ne doit pas la voir.
3. Teste l'étape
Teste l'étape : Zapier envoie l'appel et affiche la réponse de l'API. Cet appel demande le périmètre students:read et coûte un crédit, débité avant l'appel. La réponse contient trois champs à connaître :
data: les élèves de cette page, 50 au plus.has_more:truequand il reste des pages.next_cursor: le repère de la page suivante.
Un 401 UNAUTHORIZED veut dire que la clé est absente, mal recopiée ou révoquée : vérifie le mot Bearer. Un 403 SCOPE_MISSING veut dire qu'il manque un périmètre, et details.scope le nomme. Ni l'un ni l'autre ne coûte un crédit. Un paramètre refusé, comme limit=500, donne un 400 VALIDATION et coûte un crédit. Chaque test et chaque exécution du zap coûtent un crédit.
4. Sache ce que le zap ne lit pas
Chaque exécution lit une page, 50 élèves au plus avec limit=50. Quand has_more vaut true, d'autres élèves existent et ce zap ne les lit pas. Passe limit à 200, le maximum, dans l'adresse, pour une page plus grosse : une page coûte un crédit, quel que soit son nombre d'élèves.
Pour lire tous tes élèves, utilise n8n ou un script. Ta clé accepte 10 appels par seconde et 300 par minute : un 429 porte Retry-After, le nombre de secondes à attendre, et ne coûte rien.
La suite
Les cas pratiques détaillent des automatisations complètes ; leurs étapes sont écrites pour n8n et Make : un e-mail à chaque nouvel élève, une relance pour les élèves sans bilan, une relance pour les élèves inactifs et les autres cas pratiques sur l'accueil. Les deux relances envoient un message : leur clé doit pouvoir écrire. Les champs des élèves sont décrits dans la référence.