Branche Fit'Distance à tes outils

Comprendre

7 pages courtes, à lire une fois.

• Authentification

  Comment ta clé identifie chaque appel : l'en-tête Bearer, une clé par outil, la révocation et le 401.

• Périmètres

  Ce que chaque périmètre ouvre : familles et natures, périmètres sensibles, équipe, et la règle qui lie Supprimer à Écrire.

• Pagination

  Lire une liste page par page avec limit et cursor, ne relire que les changements avec since, et traiter les objets supprimés.

• Écritures et idempotence

  Écrire avec POST /operations, réessayer sans doublon avec Idempotency-Key et prévisualiser un effet avec dry_run.

• Webhooks

  Recevoir les événements de ton compte sur ton serveur : créer un webhook, vérifier la signature, répondre vite, les nouveaux essais et GET /events pour rattraper.

• Erreurs

  La forme d'une erreur de l'API, les treize codes avec leur statut HTTP et ce qu'ils coûtent, et quoi faire de chacun.

• Limites

  Les plafonds d'appels par clé, le 429 avec Retry-After et les en-têtes RateLimit, et comment reprendre sans surcharger.

Référence

Toutes les routes, générées depuis le contrat de l'API. En anglais, comme le contrat.

• Général4 routes
• Élèves3 routes
• Entraînement6 routes
• Bilans2 routes
• Formulaires3 routes
• Messagerie2 routes
• Nutrition3 routes
• Habitudes2 routes
• Rendez-vous1 route
• Cours1 route
• Activité1 route
• Opérations258 routes

Cas pratiques

Des automatisations complètes à importer dans n8n.

• Un e-mail à chaque nouvel élève

  Toutes les heures, lis les élèves arrivés depuis le dernier passage et reçois un e-mail par nouvel élève, avec n8n ou Make.

• Relancer les élèves sans bilan depuis 14 jours

  Chaque lundi, envoie un court message aux élèves qui n'ont pas envoyé de bilan depuis 14 jours, avec un premier passage sans envoi.

• Relancer les élèves inactifs

  Chaque lundi, envoie un court message aux élèves sans séance terminée depuis 14 jours, avec un premier passage sans envoi.

• Un achat en ligne → une invitation

  Quand un client règle un achat sur Stripe, invite-le dans ton coaching avec Fit'Distance, après un premier passage en aperçu, avec n8n ou Make.

• Un DM Instagram → un code d'activation, avec ManyChat

  Quand quelqu'un t'écrit un mot-clé en message privé Instagram, ManyChat lui répond avec un code d'activation créé par Fit'Distance, avec n8n ou Make.

• Un formulaire rempli → une note sur la fiche de l'élève

  Chaque réponse à un formulaire Tally devient une note privée sur la fiche de l'élève, avec n8n ou Make.

• Le récap du lundi, sur Telegram ou WhatsApp

  Chaque lundi à 8 h, reçois sur Telegram le récap de ta semaine : nouveaux élèves, séances, bilans et habitudes, avec n8n ou Make.

• Un programme se termine cette semaine → une alerte

  Chaque lundi, reçois sur Telegram la liste des programmes qui se terminent dans la semaine, avec n8n ou Make.

• Élève depuis 90 jours → une demande d'avis

  Chaque lundi, demande un avis Google aux élèves arrivés il y a trois mois, après un premier passage sans envoi, avec n8n ou Make.

• Suivre automatiquement un groupe d'élèves

  Pose un tag sur un groupe d'élèves, lis chaque matin leurs bilans en attente, écris le retour et passe le bilan à fait.

Pour les machines

Les mêmes informations, lisibles par une IA ou un générateur de client.

• Le contrat OpenAPI

  Où lire le contrat OpenAPI de l'API, comment en générer un client avec une commande, et pourquoi la référence du site dit la même chose.

• llms.txt et llms-full.txt

  Ce que contiennent les deux fichiers texte pour les IA, comment les donner à un assistant et comment lire chaque page en Markdown.

• Le serveur MCP

  L'adresse du serveur MCP et l'en-tête à lui donner avec ta clé, ce que la clé ouvre, les cinq outils gratuits et ce qui coûte un crédit.

• openapi.json
• llms.txt
• llms-full.txt