Primeiros passos

Construa sobre o Gravl.

Os seus dados de treino, programáveis. Uma REST API versionada, com scopes e apenas de leitura sobre treinos, recordes, medições e estatísticas, mais um servidor MCP que permite a assistentes de IA atuar na sua conta Gravl.

Tokens pessoais

A construir algo para si? Crie um token a partir da sua própria conta e comece a ler os seus dados num único pedido.

Apps OAuth

A construir para outros utilizadores do Gravl? Peça acesso com OAuth 2.0: os utilizadores concedem apenas os scopes que pedir.

Gravl MCP

Ligue o Claude ou qualquer cliente MCP à sua conta: registe treinos e gira o seu treino a partir de uma conversa.

A API num relance


Base URL	`https://api.gravl.ai`
Versão	Todos os endpoints vivem sob `/api/v1` e alterações incompatíveis só chegam como uma nova versão.
Formato	JSON na entrada e na saída; UTF-8; as datas são UTC ISO 8601.
Autenticação	Bearer tokens (`gat_…`) de um token pessoal ou de um grant OAuth.
Acesso	Apenas leitura por agora. Os scopes de escrita serão introduzidos de forma deliberada, nunca implícita.
CORS	Aberto (sem credenciais) em `/api/v1` e `/oauth`: as apps de browser podem chamar a API diretamente.
Estado	Beta. A superfície é estável, mas o registo de apps OAuth é manual.

O seu primeiro pedido

Obtenha um token pessoal e fica a um curl de distância do seu histórico de treino:

Listar os seus treinos

curl "https://api.gravl.ai/api/v1/workouts?page=1&pageSize=2" \
  -H "Authorization: Bearer gat_…"

{
  "items": [
    {
      "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "name": "Push Day",
      "notes": null,
      "startDate": "2026-07-12T17:03:00Z",
      "endDate": "2026-07-12T18:05:00Z",
      "durationMinutes": 62,
      "type": "custom",
      "volume": 24150,
      "calories": 410,
      "personalRecordCount": 1,
      "exerciseCount": 6
    }
  ],
  "pageNumber": 1,
  "totalPages": 87,
  "totalCount": 174,
  "hasPreviousPage": false,
  "hasNextPage": true
}

Cada token, pessoal ou OAuth, está associado a um único utilizador e a um conjunto de scopes. Não existe nenhum scope que dê acesso aos dados de outra pessoa.

Dúvidas ou ideias?

A plataforma para programadores é jovem e é moldada pelo que as pessoas constroem. Para registo de apps OAuth, dúvidas ou pedidos de funcionalidades, escreva para developers@gravl.ai.