Pierwsze kroki

Buduj na Gravl.

Twoje dane treningowe, programowalnie. Wersjonowane REST API tylko do odczytu, z dostępem opartym na scope’ach, obejmujące treningi, rekordy, pomiary i statystyki. Do tego serwer MCP, dzięki któremu asystenci AI mogą działać na Twoim koncie Gravl.

Tokeny osobiste

Budujesz coś dla siebie? Utwórz token na własnym koncie i zacznij odczytywać swoje dane jednym żądaniem.

Aplikacje OAuth

Budujesz dla innych użytkowników Gravl? Poproś o dostęp przez OAuth 2.0. Użytkownicy przyznają tylko te scope’y, o które prosisz.

Gravl MCP

Podłącz Claude’a lub dowolnego klienta MCP do swojego konta: zapisuj treningi i zarządzaj treningiem wprost z rozmowy.

API w skrócie

Bazowy URLhttps://api.gravl.ai
WersjaWszystkie endpointy żyją pod /api/v1. Zmiany łamiące zgodność zawsze wychodzą jako nowa wersja.
FormatJSON na wejściu i wyjściu; UTF-8; daty w UTC, ISO 8601.
UwierzytelnianieTokeny typu Bearer (gat_…) z tokena osobistego lub grantu OAuth.
DostępObecnie tylko odczyt. Scope’y zapisu pojawią się świadomie, a nie mimochodem.
CORSOtwarty (bez poświadczeń) na /api/v1 i /oauth. Aplikacje przeglądarkowe mogą wywoływać API bezpośrednio.
StatusBeta. Powierzchnia API jest stabilna, ale rejestracja aplikacji OAuth odbywa się ręcznie.

Twoje pierwsze żądanie

Weź token osobisty i od historii Twoich treningów dzieli Cię jeden curl:

Lista Twoich treningów
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żdy token, osobisty czy OAuth, jest powiązany z jednym użytkownikiem i zestawem scope’ów. Nie istnieje scope dający dostęp do danych kogokolwiek innego.

Pytania lub pomysły?

Platforma deweloperska jest młoda i kształtuje ją to, co ludzie na niej budują. W sprawie rejestracji aplikacji OAuth, pytań lub propozycji funkcji napisz na developers@gravl.ai.