Przejdź do głównej treści
Skorzystaj z tego przewodnika, aby znaleźć punkt badań, utworzyć wizytę dla profilu pacjenta i dodać panele badań do wykonania. Wykonaj te kroki, zanim pacjent przyjdzie na pobranie krwi.
1

Przeglądaj dostępne lokalizacje

Pobierz listę punktów badań dostępnych na twoim koncie, wysyłając żądanie GET na adres /api/v1/locations.
Odpowiedź to tablica obiektów lokalizacji:
Użyj pola timezone z obiektu lokalizacji podczas tworzenia znacznika czasu scheduled_at. Przeliczenie godziny wizyty na lokalną strefę czasową lokalizacji pomaga uniknąć umawiania poza godzinami otwarcia.
Nie wyznaczaj terminów do rezerwacji wyłącznie na podstawie open_hours. Wywołaj Pobierz dostępność i zarezerwuj zwróconą godzinę rozpoczęcia terminu — ta siatka uwzględnia również istniejące rezerwacje, wyjątki dla poszczególnych dat oraz minimalne wyprzedzenie.
2

Utwórz wizytę

Wyślij żądanie POST na adres /api/v1/appointments z ID profilu, ID lokalizacji i wybraną godziną wizyty. Godzina musi być początkiem terminu z Pobierz dostępność.
Pole scheduled_at musi zawierać przyszłą datę i godzinę w formacie ISO 8601, na przykład 2026-05-12T07:30:00Z. Znaczniki czasu z przeszłości są odrzucane z błędem 400, podobnie jak terminy z wyprzedzeniem krótszym niż 12-godzinne minimalne wyprzedzenie w lokalizacjach prowadzonych przez Aniva.
Powtórzenie tego żądania jest bezpieczne. Profil może mieć tylko jedną wizytę w danej lokalizacji i o danej godzinie, więc ponowne lub podwójne wysłanie żądania utworzenia zwraca 409 z istniejącym appointment_id zamiast rezerwować wizytę pacjenta dwa razy.
Pomyślne żądanie zwraca 201 Created z obiektem wizyty:
Zapisz id wizyty — będzie ci potrzebne do dodania paneli i potwierdzenia pobrania krwi.
3

Dodaj panele badań

Dodaj panele badań, które mają zostać wykonane na próbce krwi, wysyłając żądanie POST na adres /api/v1/appointments/{id}/panels.Identyfikatory paneli to UUID. Wywołaj Wyświetl panele, aby pobrać panele, które twój klucz API może zlecać.
Po potwierdzeniu pobrania krwi nie można już dodawać paneli. Dodaj wszystkie wymagane panele przed potwierdzeniem — szczegóły znajdziesz w Potwierdź pobranie krwi.
Pomyślne żądanie zwraca 200 OK z potwierdzeniem dodania paneli:

Zmiana terminu lub anulowanie

Po utworzeniu wizyty nadal możesz ją zmodyfikować przed potwierdzeniem pobrania krwi:
  • Zmień termin lub lokalizację — Wyślij żądanie PATCH na adres /api/v1/appointments/{id} z polami do zaktualizowania. Zobacz Zaktualizuj wizytę.
  • Anuluj — Wyślij żądanie DELETE na adres /api/v1/appointments/{id}. Zobacz Anuluj wizytę.
Obie operacje są dostępne wyłącznie przed pobraniem krwi — tj. dopóki wizyta ma status pending lub confirmed. Gdy wizyta przejdzie w status blood_drawn, żadne dalsze modyfikacje nie są możliwe.

Obsługa błędów