Začínáme

Stavěj na Gravl.

Tvoje tréninková data, programovatelně. Verzované, read-only REST API se scopes nad tréninky, rekordy, mírami a statistikami. A k tomu MCP server, díky kterému můžou AI asistenti pracovat s tvým účtem Gravl.

Osobní tokeny

Stavíš něco pro sebe? Vytvoř si token ze svého účtu a začni číst svoje data jedním requestem.

OAuth aplikace

Stavíš pro ostatní uživatele Gravl? Požádej o přístup přes OAuth 2.0. Uživatelé udělí jen ty scopes, o které si řekneš.

Gravl MCP

Připoj Claude nebo libovolného MCP klienta ke svému účtu: loguj tréninky a řiď svůj trénink přímo z konverzace.

API v kostce

Base URLhttps://api.gravl.ai
VerzeVšechny endpointy žijí pod /api/v1; breaking changes vyjdou vždy jen jako nová verze.
FormátJSON na vstupu i výstupu; UTF-8; datumy jsou UTC ISO 8601.
AutentizaceBearer tokeny (gat_…) z osobního tokenu nebo OAuth grantu.
PřístupZatím jen pro čtení. Zápisové scopes přibudou promyšleně, ne implicitně.
CORSOtevřený (bez credentials) na /api/v1 a /oauth; prohlížečové aplikace můžou volat API napřímo.
StatusBeta. Rozhraní je stabilní, ale registrace OAuth aplikací probíhá ručně.

Tvůj první request

Vezmi si osobní token a od své tréninkové historie tě dělí jeden curl:

Výpis tvých tréninků
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
}

Každý token, osobní i OAuth, je vázaný na jednoho uživatele a sadu scopes. Neexistuje scope, který by zpřístupnil data někoho jiného.

Otázky nebo nápady?

Vývojářská platforma je mladá a tvaruje ji to, co na ní lidé stavějí. Ohledně registrace OAuth aplikací, dotazů nebo návrhů na nové funkce napiš na developers@gravl.ai.