Dokumentacja

Steruj Dziennikiem Alergika z zewnątrz — przez API albo MCP, własnym tokenem.

Autoryzacja

Każde wywołanie poniżej — API czy MCP — wymaga nagłówka Authorization z osobistym tokenem przypisanym do Twojego konta. Token nie wygasa, ale możesz go w każdej chwili unieważnić i wygenerować nowy — stary natychmiast przestaje działać.

Authorization: Bearer dz_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
POST

/api/v1/entries

Dodaje nowy wpis. Domyślnie na dziś.

Body (JSON)

  • datestringopcjonalne

    YYYY-MM-DD. Domyślnie dzisiejsza data.

  • moodnumberopcjonalne

    1-5. Domyślnie 3.

  • symptomsstringopcjonalne

    Opis objawów.

  • medicinestringopcjonalne

    Przyjęte lekarstwo.

  • skippedbooleanopcjonalne

    Czy lekarstwo zostało pominięte. Domyślnie false.

curl -X POST https://dziennik-alergika.vercel.app/api/v1/entries \
  -H "Authorization: Bearer dz_..." \
  -H "Content-Type: application/json" \
  -d '{"mood": 4, "symptoms": "lekki katar"}'

Odpowiedź 201

{
  "id": 123,
  "date": "2026-06-16",
  "mood": 4,
  "symptoms": "lekki katar",
  "medicine": null,
  "skipped": false,
  "createdAt": "2026-06-16T10:00:00.000Z"
}
POST

/api/v1/ask

Zadaje pytanie agentowi AI, opcjonalnie z kontekstem konkretnego dnia.

Body (JSON)

  • questionstringwymagane

    Treść pytania do agenta.

  • datestringopcjonalne

    YYYY-MM-DD. Przesuwa standardowe 7-dniowe okno kontekstu tak, by kończyło się na tym dniu (domyślnie okno kończy się dziś).

Endpoint wymaga włączonej zgody na przetwarzanie danych przez AI (ta sama zgoda co w czacie w aplikacji) i wlicza się w ten sam dzienny limit 15 wiadomości. Pytanie i odpowiedź zapisują się jako nowa konwersacja, widoczna potem w historii czatu.

curl -X POST https://dziennik-alergika.vercel.app/api/v1/ask \
  -H "Authorization: Bearer dz_..." \
  -H "Content-Type: application/json" \
  -d '{"question": "Jak minął mi ten tydzień?"}'

Odpowiedź 200

{
  "conversationId": "9f1c...",
  "answer": "W tym tygodniu..."
}

Błędy

  • 403 consent_required — brak zgody na AI w ustawieniach aplikacji.
  • 429 rate_limited — przekroczony dzienny limit 15 wiadomości.
GET

/api/v1/entries

Pokazuje wpis z konkretnego dnia.

Query params

  • datestringwymagane

    YYYY-MM-DD. Dzień, dla którego ma zostać zwrócony wpis.

curl "https://dziennik-alergika.vercel.app/api/v1/entries?date=2026-06-16" \
  -H "Authorization: Bearer dz_..."

Odpowiedź 200

{
  "id": 123,
  "date": "2026-06-16",
  "mood": 4,
  "symptoms": "lekki katar",
  "medicine": null,
  "skipped": false,
  "createdAt": "2026-06-16T10:00:00.000Z"
}

Jeśli dla podanego dnia nie ma wpisu, odpowiedź to 404 { "error": "not_found" }.