API per sviluppatori e agenti IA

Un accesso semplice per leggere e scrivere
dati di allenamento in Nolio.
I dati circolano in entrambe le direzioni tra la tua applicazione, l'API Nolio e Nolio.

Accedi al portale API

Vai al portale API

Cosa puoi fare

Allenamenti

  • Leggere, creare, modificare ed eliminare allenamenti
  • Leggere, creare, modificare ed eliminare gare
  • Leggere i dati di allenamento

Utente

  • Leggere le informazioni utente
  • Accedere ai propri atleti

Metriche

  • Leggere e aggiornare le metriche: HRV, VO2, FTP, MAP, FC max, peso...

Record

  • Leggere i record

Note

  • Leggere le note

File

  • Caricare un file
Vedi la documentazione dell'API

Eventi in tempo reale con i webhook

Gli sviluppatori ricevono webhook per accedere agli allenamenti pianificati, agli allenamenti svolti, alle metriche e molto altro.

L'API Nolio fornisce gli strumenti per sviluppare
con Claude, Gemini o ChatGPT.

You are the Nolio API onboarding assistant. You guide coaches (or their devs) in connecting their tool to the Nolio ecosystem. Answer briefly, give ready-to-paste code, in the user's language (EN by default).
# Response rules
- Always HTTPS. Never a `client_secret` on the front end, public mobile, or browser JS.
- If the user asks for an endpoint or field not listed here, DO NOT INVENT IT: refer them to the documentation (https://github.com/NolioApp/NolioAPI-Documentation/).
- Always recommend a trailing `/` on endpoints (always valid; some POSTs accept it without, but better to stay consistent).
- No public sandbox environment: use a dedicated test account on prod.
- No URL versioning (no `v1/v2`). Changes are announced on the wiki — always point to the up-to-date docs.
# Getting started
- Auth: OAuth2 authorization-code. Create your app in the API portal to get your client_id / client_secret, then exchange the authorization code at POST /api/token/.
- Full reference (endpoints, fields, scopes, examples): https://github.com/NolioApp/NolioAPI-Documentation/

La sicurezza prima di tutto

L'accesso all'API è protetto dal protocollo OAuth.

Il protocollo OAuth identifica l'applicazione e l'account utente che accede ai dati. Tutte le richieste all'API richiedono un token OAuth valido.

Vedi la documentazione OAuth

Integra il marchio Nolio

Loghi, colori, mockup: tutti gli asset di cui hai bisogno.
Vedi il media kit

Nolio MCP

Il modo più semplice per far comunicare il tuo agente con Nolio.
Collega il mio assistente IA

Usare Nolio con il tuo assistente IA

Requisiti

  • Un account Nolio a pagamento: un abbonamento allenatore o Atleta Premium.
  • Un assistente compatibile con MCP: Claude, ChatGPT, Grok, Le Chat, Perplexity, Cursor, VS Code o Codex.

Connessione con Claude

  1. Aggiungi il connettore Nolio dalla directory di Claude.
  2. Accedi con il tuo account Nolio e scegli le autorizzazioni da concedere a Claude: lettura, creazione, modifica, eliminazione.

Connessione con ChatGPT

  1. Installa il plugin Nolio dalla directory di ChatGPT.
  2. Accedi con il tuo account Nolio e scegli le autorizzazioni da concedere a ChatGPT: lettura, creazione, modifica, eliminazione.

Esempi

  • Mostrami il mio calendario di allenamento della settimana.
  • Quali allenamenti ha svolto Léa negli ultimi 7 giorni, rispetto a quanto era pianificato?
  • Aggiungi giovedì a Léa un allenamento di corsa: 15 min di riscaldamento, 6 × 800 m in zona 5 con 2 min di recupero in zona 1, poi 10 min di defaticamento.
  • Analizza il passo e la frequenza cardiaca di Jean tra un ristoro e l'altro all'Ultra Trail du Mont Bleu.
  • Applica il mio modello «Lungo Z2» a tutto il gruppo Maratona domenica prossima.
  • Sposta l'allenamento di Paul da martedì a mercoledì.
  • Come sono cambiati l'HRV e il sonno di Paul nelle ultime due settimane?

Come funziona

  • Una creazione o un'eliminazione si può annullare. Una modifica no.
  • Un allenatore accede solo agli atleti che allena. Una squadra può limitare le azioni dei propri allenatori dalle sue opzioni.
  • I dati di alcuni servizi collegati non vengono trasmessi agli assistenti IA, nel rispetto delle condizioni di tali servizi.

Risoluzione dei problemi

  • Se il tuo assistente segnala un'autorizzazione mancante, ricollega Nolio e spunta l'autorizzazione richiesta.
  • Per revocare l'accesso: Impostazioni > MCP e API in Nolio, oppure le impostazioni dei connettori del tuo assistente.
  • Altro assistente compatibile con MCP: aggiungi un connettore personalizzato con lo stesso indirizzo. Se non riesce ad aprire la pagina di accesso, usa un token personale.

Altri assistenti

Aggiungi un connettore con l'indirizzo https://mcp.nolio.io/mcp, poi accedi con il tuo account Nolio.

  • Grok: su grok.com/connectors, clicca su «New Connector», scegli «Custom» e incolla l'indirizzo.
  • Le Chat: in Connettori, aggiungi un connettore personalizzato e incolla l'indirizzo.
  • Perplexity: con l'abbonamento Pro, Impostazioni > Connettori > «+ Custom connector» > «Remote», poi incolla l'indirizzo.
  • Cursor: aggiungi a Cursor, oppure aggiungi l'indirizzo in ~/.cursor/mcp.json.
  • Codex: codex mcp add nolio --url https://mcp.nolio.io/mcp poi codex mcp login nolio.
  • Claude Code: claude mcp add --transport http nolio https://mcp.nolio.io/mcp poi /mcp per accedere.
  • VS Code: aggiungi a VS Code.