Documentation technique : toutes les routes API, autorisations et exemples à jour se trouvent sur docs.fitsociety.io. Pour les développeurs, commence par le guide de démarrage rapide de la Public API.
Dans cet article
Le module API de l'app FITsociety dans Make est destiné aux scénarios avancés dans lesquels tu veux utiliser directement une route prise en charge de la Public API. Pour les actions courantes, comme mettre à jour un membre ou créer une réservation, les modules d'action FITsociety disponibles sont généralement plus simples.
Le module API utilise la même connexion, la même entreprise et les mêmes droits que tes autres modules. Il ne donne pas d'accès supplémentaire aux données. Tu as besoin d'un accès à l'app FITsociety ; demande l'app privée au support si elle n'est pas encore disponible dans ton compte Make.
Préparer une requête de lecture
Recherche la description actuelle de la route de la FITsociety Public API souhaitée.
Vérifie la méthode HTTP, le chemin, les droits nécessaires et les champs de saisie.
Ajoute le module API et sélectionne la connexion avec la bonne entreprise.
Pour une requête de lecture, choisis GET et saisis le chemin relatif selon l'aide du module.
Ajoute les paramètres de requête requis dans les champs prévus à cet effet.
Clique sur Run once et vérifie le contenu de la réponse et le code de statut.
Un test de connexion utilise la route de la Public API GET /public/v1/me. La partie que tu en saisis dans le module dépend du chemin de base que le module utilise déjà. Suis l'aide du module et ne saisis pas simplement une URL complète du site web ou un chemin de l'environnement coach.
L'authentification passe par la connexion sélectionnée. Ne copie pas de jeton d'accès d'une autre intégration dans ton scénario. Une connexion fonctionnelle ne donne accès qu'aux routes pour lesquelles un consentement a été accordé.
Une requête qui modifie des données
Utilise uniquement une méthode d'écriture prise en charge à la fois par le module et par la route API concernée. Indique un identifiant source stable dans le champ prévu à cet effet, comme Source operation key. Garde la même valeur et la même saisie lorsque tu répètes la même modification.
Un corps JSON doit contenir du JSON valide. Les nombres y utilisent un point comme séparateur décimal, par exemple 172.5. N'utilise pas d'unités ni de montants formatés. Les champs de date sans heure utilisent YYYY-MM-DD ; les horodatages suivent le format avec fuseau horaire exigé par l'API.
Pour mapper du texte libre, utilise un générateur JSON afin que les guillemets et les retours à la ligne soient correctement traités. Teste les actions d'écriture avec des données fictives. Une requête réussie peut entraîner des modifications, des notifications et d'autres effets normaux.
Vérifier les résultats et plusieurs pages
Vérifie dans le contenu de la réponse si l'enregistrement visé a été trouvé ou modifié. Un code de statut de réussite ne dit pas à lui seul si ton scénario a traité tous les enregistrements souhaités.
Ne pars pas du principe qu'un module API récupère automatiquement toutes les pages. Utilise la pagination prise en charge par la route et le module, et vérifie s'il reste des résultats. Demande au support FITsociety la bonne documentation si tu n'es pas sûr de la route, des droits ou de la pagination adaptés à ton objectif.
Pas encore de connexion ? Lis Connecter FITsociety à Make.