Interfejs API REST

Przegląd

Wtyczka udostępnia rozszerzony interfejs API REST, umożliwiający programowy dostęp do danych dotyczących rezerwacji.
Interfejs API obsługuje zaawansowane filtrowanie i zwraca wszystkie statusy rezerwacji z możliwością elastycznego filtrowania według przedziałów czasowych.

Adres bazowy:
/wp-json/baza-booking-calendar/v1/

Punkty końcowe

Wyświetl wszystkie zarezerwowane terminy z wykorzystaniem filtrów

Żądanie:
GET /wp-json/baza-booking-calendar/v1/slots/

Parametry zapytania:

• status (ciąg znaków, opcjonalne) – Filtrowanie według statusu rezerwacji. Obsługuje pojedynczy status lub wiele wartości oddzielonych przecinkami.
• start (ciąg znaków, opcjonalnie) – Filtrowanie według daty rozpoczęcia. Obsługiwane formaty: DD.MM.YYYY, DD/MM/YYYY, YYYY-MM-DD.
• end (ciąg znaków, opcjonalne) – Filtrowanie według daty zakończenia. Formaty są takie same jak w przypadku start.
• filter_by (ciąg znaków, opcjonalnie) – Typ filtra: booking_date (domyślnie) lub created_date.
• flat (boolean, opcjonalny) – Zwraca booked_slots jako płaską tablicę rezerwacji zamiast grupować je według identyfikatora usługi. Przydatne w przypadku integracji, takich jak Zapier, które oczekują zwykłej listy rekordów.

Odpowiedź w formacie płaskim dla integracji:
/wp-json/baza-booking-calendar/v1/slots/?flat=1

Dostępne statusy

• w toku – oczekuje się na potwierdzenie
• zarezerwowane – Potwierdzona rezerwacja
• odrzucić – Rezerwacja została odrzucona
• zrealizowano – Rezerwacja zrealizowana
• wygasła – Wygasła rezerwacja

Przykłady zapytań

Wszystkie rezerwacje:
/wp-json/baza-booking-calendar/v1/slots/

Tylko aktywne rezerwacje:
/wp-json/baza-booking-calendar/v1/slots/?status=pending,booked

Zrealizowane i odrzucone rezerwacje na czerwiec 2025 r.:
/wp-json/baza-booking-calendar/v1/slots/?status=completed,reject&start=01.06.2025&end=30.06.2025

Wszystkie rezerwacje w określonym przedziale czasowym:
/wp-json/baza-booking-calendar/v1/slots/?start=01/06/2025&end=30/06/2025

Zarezerwuj terminy na konkretną usługę

Żądanie:
GET /wp-json/baza-booking-calendar/v1/slots/?service={slug}
GET /wp-json/baza-booking-calendar/v1/slots/?service={ID}

Parametry:

• usługa (ciąg znaków, wymagane) – skrót lub identyfikator usługi (np. massage-therapy, yoga-classlub ID).
• status (ciąg znaków, opcjonalny) – Tak samo jak powyżej.
• start (ciąg znaków, opcjonalnie) – data rozpoczęcia.
• end (ciąg znaków, opcjonalnie) – Data zakończenia.

Przykłady zapytań

Wszystkie rezerwacje dotyczące usługi masażu:
/wp-json/baza-booking-calendar/v1/slots/?
service=massage-therapy/wp-json/baza-booking-calendar/v1/slots/?service={ID}

Aktywne rezerwacje usługi masażu:
/wp-json/baza-booking-calendar/v1/slots/?service=massage-therapy&status=pending,booked

Typowe przypadki zastosowań

Sprawdź godziny, w których usługa jest niedostępna (poza godzinami pracy, dni wolne)

Żądanie:
GET /wp-json/baza-booking-calendar/v1/disabled-time/

Parametry:

• usługa (ciąg znaków, opcjonalnie) – skrót lub identyfikator usługi (np. studio-1 lub ID).
• start (ciąg znaków, opcjonalnie) – data rozpoczęcia.
• end (ciąg znaków, opcjonalnie) – Data zakończenia.

Przykłady zapytań

Wszystkie zablokowane terminy na najbliższe 3 miesiące:
/wp-json/baza-booking-calendar/v1/disabled-time/

Dla konkretnej usługi:
/wp-json/baza-booking-calendar/v1/disabled-time/?
service=studio-1/wp-json/baza-booking-calendar/v1/disabled-time/?service={ID}

Dla określonego przedziału czasowego:
/wp-json/baza-booking-calendar/v1/disabled-time/?start=01.12.2025&end=31.12.2025