Szybki start

Ten przewodnik przeprowadzi Cię przez utworzenie tokenu API i wykonanie pierwszego zapytania.

1. Utwórz token API

Pobierz aplikację mobilną Ogarni.AI (App Store | Google Play)
Zaloguj się do aplikacji
Przejdź do Ustawienia > Tokeny API
Kliknij Utwórz nowy token
Wybierz uprawnienie read (wystarczające do odczytu danych)
Skopiuj wygenerowany token — zaczyna się od oai_

2. Zapisz token

Zapisz token jako zmienną środowiskową:

export OGARNIAI_API_TOKEN="oai_twoj_token_tutaj"

3. Wykonaj pierwsze zapytanie

Pobierz ostatnie podsumowanie tygodniowe:

curl -X GET "https://api.ogarni.ai/api/weekly-summaries/latest" \
  -H "X-API-Key: $OGARNIAI_API_TOKEN" \
  -H "Accept: application/json"

4. Sprawdź wynik

Powinieneś otrzymać odpowiedź JSON z podsumowaniem wydatków:

{
  "periodStart": "2025-01-06T00:00:00Z",
  "periodEnd": "2025-01-12T23:59:59Z",
  "totalAmount": 850.00,
  "summary": "W tym tygodniu wydałeś 850 PLN...",
  "categoryTotals": [
    { "category": "Spożywcze", "totalAmount": 350.00 },
    { "category": "Transport", "totalAmount": 120.00 }
  ]
}

5. Pobierz listę dokumentów

Sprawdź swoje ostatnie paragony:

curl -X GET "https://api.ogarni.ai/api/PurchaseDocuments/my?sortBy=purchase_time&sortDirection=desc" \
  -H "X-API-Key: $OGARNIAI_API_TOKEN" \
  -H "Accept: application/json"

Co dalej?

Tokeny API — szczegóły o uprawnieniach i bezpieczeństwie tokenów
Endpointy — pełna lista dostępnych endpointów
Przykłady kodu — gotowe przykłady w curl, Python i JavaScript
Serwer MCP — integracja z modelami językowymi