API para programadores e agentes de IA

Um acesso simples para ler e escrever
dados de treino no Nolio.
Os dados circulam nos dois sentidos entre a tua aplicação, a API do Nolio e o Nolio.

Aceder ao portal da API

Ir para o portal da API

O que podes fazer

Treinos

  • Ler, criar, editar e eliminar treinos
  • Ler, criar, editar e eliminar provas
  • Ler os dados de treino

Utilizador

  • Ler as informações do utilizador
  • Aceder aos atletas do treinador

Métricas

  • Ler e atualizar as métricas: VFC, VO2, FTP, PAM, FC máx, peso...

Recordes

  • Ler os recordes

Notas

  • Ler as notas

Ficheiro

  • Carregar um ficheiro
Ver a documentação da API

Eventos em tempo real com webhooks

Os programadores recebem webhooks para aceder aos treinos planeados, aos treinos realizados, às métricas e muito mais.

A API do Nolio fornece as ferramentas para desenvolver
com Claude, Gemini ou 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/

Segurança em primeiro lugar

O acesso à API está protegido pelo protocolo OAuth.

O protocolo OAuth identifica a aplicação e a conta de utilizador que acede aos dados. Todos os pedidos à API exigem um token OAuth válido.

Ver a documentação OAuth

Integra a marca Nolio

Logótipos, cores, mockups: todos os recursos gráficos de que precisas.
Ver o media kit

Nolio MCP

A forma mais simples de o teu agente comunicar com o Nolio.
Ligar o meu assistente de IA

Utilizar o Nolio com o teu assistente de IA

Pré-requisitos

  • Uma conta Nolio paga: uma subscrição de treinador ou Atleta Premium.
  • Um assistente compatível com MCP: Claude, ChatGPT, Grok, Le Chat, Perplexity, Cursor, VS Code ou Codex.

Ligação com o Claude

  1. Adiciona o conector Nolio a partir do diretório do Claude.
  2. Inicia sessão com a tua conta Nolio e escolhe as permissões concedidas ao Claude: leitura, criação, alteração, eliminação.

Ligação com o ChatGPT

  1. Instala o plugin Nolio a partir do diretório do ChatGPT.
  2. Inicia sessão com a tua conta Nolio e escolhe as permissões concedidas ao ChatGPT: leitura, criação, alteração, eliminação.

Exemplos

  • Mostra-me o meu calendário de treino desta semana.
  • Que treinos fez a Léa nos últimos 7 dias, em comparação com o que estava planeado?
  • Adiciona um treino de corrida à Léa na quinta-feira: 15 min de aquecimento, 6 × 800 m na zona 5 com 2 min de recuperação na zona 1 e depois 10 min de arrefecimento.
  • Analisa o ritmo e a frequência cardíaca do Jean entre os abastecimentos do Ultra Trail du Mont Bleu.
  • Aplica o meu modelo «Treino longo Z2» a todo o grupo Maratona no próximo domingo.
  • Passa o treino de terça-feira do Paul para quarta-feira.
  • Como evoluíram a VFC e o sono do Paul nas últimas duas semanas?

Como funciona

  • Uma criação ou uma eliminação pode ser desfeita. Uma alteração, não.
  • Um treinador só tem acesso aos atletas que treina. Uma equipa pode restringir as ações dos seus treinadores nas opções da equipa.
  • Os dados de alguns serviços ligados não são transmitidos aos assistentes de IA, em conformidade com os termos desses serviços.

Resolução de problemas

  • Se o teu assistente indicar uma permissão em falta, volta a ligar o Nolio e marca a permissão pedida.
  • Para retirar o acesso: Definições > MCP e API no Nolio, ou as definições de conectores do teu assistente.
  • Outro assistente compatível com MCP: adiciona um conector personalizado com o mesmo endereço. Se não conseguir abrir a página de início de sessão, utiliza um token pessoal.

Outros assistentes

Adiciona um conector com o endereço https://mcp.nolio.io/mcp e depois inicia sessão com a tua conta Nolio.

  • Grok: em grok.com/connectors, clica em «New Connector», escolhe «Custom» e cola o endereço.
  • Le Chat: em Conectores, adiciona um conector personalizado e cola o endereço.
  • Perplexity: com a subscrição Pro, Definições > Conectores > «+ Custom connector» > «Remote» e depois cola o endereço.
  • Cursor: adicionar ao Cursor ou adiciona o endereço em ~/.cursor/mcp.json.
  • Codex: codex mcp add nolio --url https://mcp.nolio.io/mcp e depois codex mcp login nolio.
  • Claude Code: claude mcp add --transport http nolio https://mcp.nolio.io/mcp e depois /mcp para iniciares sessão.
  • VS Code: adicionar ao VS Code.