Per iniziare
Costruisci su Gravl.
I tuoi dati di allenamento, programmabili. Una REST API versionata, con scope e in sola lettura su allenamenti, record, misurazioni e statistiche, più un server MCP che permette agli assistenti AI di agire sul tuo account Gravl.
Token personali
Stai costruendo qualcosa per te? Crea un token dal tuo account e inizia a leggere i tuoi dati con una sola richiesta.
App OAuth
Stai costruendo per altri utenti Gravl? Richiedi l'accesso con OAuth 2.0: gli utenti concedono solo gli scope che chiedi.
Gravl MCP
Collega Claude o qualsiasi client MCP al tuo account: registra allenamenti e gestisci il tuo training da una conversazione.
L'API in sintesi
| Base URL | https://api.gravl.ai |
| Versione | Tutti gli endpoint vivono sotto /api/v1: le breaking change arrivano solo come nuova versione. |
| Formato | JSON in ingresso e in uscita; UTF-8; le date sono UTC ISO 8601. |
| Autenticazione | Bearer token (gat_…) da un token personale o da un grant OAuth. |
| Accesso | Oggi in sola lettura. Gli scope di scrittura verranno introdotti in modo deliberato, mai implicito. |
| CORS | Aperto (senza credenziali) su /api/v1 e /oauth: le app browser possono chiamare l'API direttamente. |
| Stato | Beta: la superficie è stabile, ma la registrazione delle app OAuth è manuale. |
La tua prima richiesta
Procurati un token personale e una curl ti separa dalla tua cronologia di allenamenti:
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
}Ogni token, personale o OAuth, è legato a un solo utente e a un insieme di scope. Non esiste uno scope che dia accesso ai dati di qualcun altro.
Domande o idee?
La piattaforma per sviluppatori è giovane e prende forma da ciò che le persone costruiscono. Per la registrazione di app OAuth, domande o richieste di funzionalità, scrivi a developers@gravl.ai.