Passer au contenu principal

Utiliser l'API Nolio : token personnel, permissions et quotas

Générer un token, choisir ses permissions, suivre ses quotas et ses logs, demander une application partenaire et recevoir des webhooks.

Écrit par Romain Malbreil

L'API Nolio te donne accès en lecture et en écriture à tes données : calendrier prévu et réalisé, séances, compétitions, notes, métriques, zones, modèles, équipes et sportifs. Tout se règle depuis tes Réglages, dans le bloc MCP et API. Cette page te permet de :

  • générer ton token personnel et faire ton premier appel ;

  • choisir les permissions de ton application et de tes tokens ;

  • suivre tes quotas et tes logs ;

  • demander une application partenaire et recevoir des webhooks.

📌 À retenir
​
L'API et le serveur MCP sont réservés aux Sportifs Premium et aux entraîneurs. Sans abonnement, la page affiche Disponible avec un abonnement et un bouton Voir les abonnements. Ton accès est déjà prêt : dès que ton abonnement est actif, tout fonctionne sans autre étape.


1. Les pages MCP et API

Dans le menu de gauche de tes Réglages, descends jusqu'au bloc MCP et API.

Page

À quoi elle sert

Tableau de bord

Ta consommation en temps réel et les logs des dernières 24 heures.

MCP > Démarrage rapide / Fonctionnalités

Connecter Nolio à ton assistant IA (voir l'article dédié).

API > Démarrage rapide

Le premier appel, avec des exemples prêts à copier en curl, Python, JavaScript, PHP et Go.

Application personnelle

Tes tokens, tes permissions et tes identifiants OAuth 2.

Application partenaires

Pour un produit que d'autres comptes Nolio connectent au leur.

Webhooks

Recevoir une notification dès qu'une donnée change.

Documentation

La référence complète de l'API, dans un nouvel onglet.


2. Générer ton token personnel

Le token d'accès personnel est le moyen le plus simple d'utiliser l'API : il agit avec ton compte, sans callback ni flux d'autorisation, et reste valable jusqu'à ce que tu le révoques.

  1. Ouvre Application personnelle.

  2. Dans Token d'accès personnel, clique sur Générer un token.

  3. Choisis les permissions du token.

  4. Clique sur Valider.

  5. Copie le token affiché.

📌 À retenir
​
Le token n'est visible qu'une seule fois. Conserve-le en lieu sûr : Nolio ne pourra jamais te le réafficher. Ensuite, la page n'en montre que les 4 derniers caractères.

Pour vérifier qu'il fonctionne, ouvre API > Démarrage rapide et copie l'exemple dans le langage de ton choix. Il interroge la route /api/v2/me/, qui renvoie le compte connecté.


​Gérer un token existant

  • Modifier les permissions : change ce que le token peut faire, sans le régénérer ;

  • Générer un second token : utile pour séparer deux usages (un script, un tableau de bord) ;

  • l'icône corbeille révoque le token. Les intégrations qui l'utilisent cessent de fonctionner immédiatement.

Sous chaque token, Nolio indique la date de sa dernière utilisation, ou Jamais utilisé.

📌 À retenir
​
Ton token personnel est pour toi seul. Ne le prête pas et ne demande pas le leur à d'autres comptes : si ton produit connecte d'autres utilisateurs, passe par une application partenaire (partie 5).


3. Choisir les permissions

Les permissions sont rangées par univers. Pour chacun, tu choisis Lecture, Écriture, Suppression ou Aucune.

  • Calendrier prévu, Calendrier réalisé, Métriques, Messagerie, Modèles, Paramètres, Équipe, Marketplace : lecture, écriture, suppression ;

  • Facturation : lecture seulement ;

  • Applications API : gestion, réservée à l'application (jamais sur un token).

Il y a deux niveaux :

  1. Permissions de l'application : le plafond. Clique sur Modifier pour le réduire. L'écran d'autorisation OAuth ne propose que ces permissions.

  2. Permissions du token : ce que chaque token a le droit de faire, dans la limite du plafond.

💡 Astuce
​
Ne garde que ce dont ton outil a besoin. Un tableau de bord qui affiche la charge n'a besoin que de la lecture. Si tu retires une permission de l'application, tous les tokens et autorisations existants la perdent immédiatement.


4. Suivre tes quotas et tes logs

Le Tableau de bord affiche tes Opérations API horaires et Opérations API journalières, avec le délai avant la remise à zéro.

Compte

Quota

Sportif Premium

1 000 appels par heure et 5 000 par jour.

Entraîneur

2 000 appels par heure et 10 000 par jour, plus un supplément qui grandit avec le nombre de sportifs suivis (recalculé chaque nuit).

Au-delà, l'API répond 429. Chaque appel compte, même refusé pour quota dépassé, et un lot compte en plus chacune de ses opérations quand il est accepté.

Sous les compteurs, la liste Logs montre les appels des dernières 24 heures : l'origine (MCP ou API), le code de réponse, la route et l'heure. Clique sur une ligne pour voir le détail : requête, durée, erreur éventuelle, corps envoyé et reçu. Les appels refusés (401, 403) y apparaissent aussi.


5. Brancher un produit pour d'autres comptes : l'application partenaire

Chaque compte a deux applications, avec des identifiants distincts :

  • Application personnelle : pour toi, ton équipe et tes sportifs. Disponible tout de suite ;

  • Application partenaires : pour un produit que d'autres coachs ou sportifs Nolio connectent à leur compte, en dehors des tiens. Elle passe par le flux OAuth2 authorization_code.

Comme elle accède aux données d'autres personnes, l'application partenaire est activée par Nolio après examen de ta demande.

  1. Ouvre Application partenaires.

  2. Clique sur Demander une application partenaires.

  3. Renseigne ton identité : image, nom, qui tu es. C'est ce que verront les utilisateurs au moment d'autoriser ton application.

  4. Réponds aux six questions sur ton projet : public visé, cas d'usage, données utilisées, traitement et stockage, mesures de protection, volumétrie.

  5. Clique sur Envoyer la demande.

Le message Ta demande a été transmise. Nous revenons vers toi rapidement. Confirme l'envoi. Une fois l'application activée, ses identifiants apparaissent sur la même page et un sélecteur Application personnelle / Application partenaires s'ajoute au tableau de bord.

📌 À retenir
​
L'application partenaire n'a pas de plafond fixe : chaque utilisateur synchronisé ajoute 50 appels par heure et 250 par jour.


6. Recevoir des webhooks

Un webhook envoie une notification à ton serveur dès qu'une donnée change, sans que tu aies à la demander. Sur la page Webhooks :

  1. Colle l'adresse de ton serveur dans URL, puis clique sur Enregistrer. Une seule URL par application.

  2. Génère la Clé de vérification : c'est le secret avec lequel Nolio signe chaque envoi.

  3. Dans Évènements, coche ce que tu veux recevoir, puis clique sur Enregistrer.

  4. Clique sur Envoyer un test pour vérifier que ton serveur répond.

Par défaut, seules les séances prévues et réalisées créées ou modifiées sont envoyées. Les autres évènements (compétitions, notes, cycles, messages, questionnaires, métriques, équipe, facturation) se cochent à la main. Un univers sans la permission de lecture n'envoie jamais rien.

📌 À retenir
​
Si ton serveur ne répond pas sur trop d'envois consécutifs, Nolio coupe l'envoi et affiche Endpoint désactivé automatiquement. Vérifie qu'il répond bien, puis clique sur Réactiver. Le format des envois et la vérification de signature sont détaillés en haut de la page Webhooks, dans Qu'est-ce qu'un webhook ?



😵‍💫 Tu as besoin d'aide ?
​N'hésite pas à nous contacter

Avez-vous trouvé la réponse à votre question ?