Vue d'ensemble

Ce que l'API Fit'Distance te permet de faire, les trois façons d'appeler l'API et les règles à retenir avant ta première clé.

L'API partenaires relie Fit'Distance aux outils que tu utilises déjà : n8n, Make, Zapier, un script à toi, ton terminal ou une IA comme Claude ou ChatGPT. Tu lis les données de tes élèves, et tu écris dans toutes les familles.

Ce que tu peux faire

Lire tes élèves, y compris ceux qui sont partis, leurs programmes, séances, ressentis et résultats de séries, leurs bilans, habitudes, formulaires (assignations, soumissions et réponses), messages, plans alimentaires, journal des repas, macros, rendez-vous, progression dans tes formations et phases de coaching, et tes prospects.
Écrire dans toutes les familles : élèves, prospects, programmes, séances, bilans, messages, formulaires, nutrition, habitudes, rendez-vous, formations, documents, tâches. Ces actions passent par des opérations, appelées avec POST /operations/<nom>.
Voir la liste exacte des opérations avec GET /operations. Cet appel ne demande ni clé ni crédit.

Trois façons d'appeler l'API

Les trois utilisent la même clé, envoyée dans l'en-tête Authorization: Bearer fd_live_xxxxxxxx, et les mêmes opérations.

Façon	Adresse	Pour qui
REST	`https://api.fitdistance.io/api/partner/v1`	n8n, Make, Zapier, tes scripts
MCP	`https://mcp.fitdistance.io`	Une IA compatible MCP avec qui tu discutes, comme Claude ou ChatGPT
CLI	`npx @fitdistance/cli`	Ton terminal, un script ou un agent qui code

Par le MCP, l'IA n'agit que dans les périmètres de la clé, comme n'importe quel autre outil.

Les règles à retenir

Une clé par outil. Tu as cinq clés actives au plus. Si un outil change de mains, tu révoques sa clé sans toucher aux autres, et le journal des appels dit quelle clé a fait quoi.
Un crédit par appel facturé. Les trois puisent dans les mêmes crédits. Quatre routes sont gratuites : GET /me (ta clé et ton solde), GET /openapi.json (le contrat de l'API), GET /operations (le catalogue) et GET /events (les événements de tes webhooks). GET /openapi.json et GET /operations se lisent sans clé.
Une cadence par clé. 10 appels par seconde et 300 par minute, dont 60 écritures et 20 suppressions par minute au plus. Au-delà, tu reçois un 429, qui ne coûte rien.
Des périmètres. Quand tu crées une clé, tu coches ce qu'elle peut lire, écrire ou supprimer. Elle ne sort jamais de là.

Choisis ta porte

Je branche n8n : une clé, un identifiant, un nœud, sans coder.
Je branche Make : le module HTTP et la pagination.
Je branche Zapier : une requête personnalisée avec ta clé dans l'en-tête.
J'écris un script : Python ou JavaScript, de la pagination à l'écriture.
J'utilise la ligne de commande : la commande fitdistance, pour un script ou un agent qui code.
Je donne la doc à mon IA : le lien llms.txt, ou le serveur MCP avec ta clé.

Pour commencer

Crée une clé dans l'app.
Fais ton premier appel : il est gratuit.
Comprends les clés et les crédits avant de brancher un outil.

Toutes les routes sont dans la référence. Le contrat complet est dans openapi.json, et llms.txt le résume pour une IA.