REST API

Огляд

Плагін надає розширений REST API для програмного доступу до даних про бронювання.
API підтримує розширену фільтрацію та повертає всі статуси бронювання з можливістю гнучкої фільтрації за діапазоном дат.

Базова URL-адреса:
/wp-json/baza-booking-calendar/v1/

Кінцеві точки

Отримати всі заброньовані слоти за допомогою фільтрів

Запит:
GET /wp-json/baza-booking-calendar/v1/slots/

Параметри запиту:

• статус (рядок, необов’язковий) – фільтрування за статусом бронювання. Можна вказати один статус або кілька значень, розділених комами.
• start (рядок, необов’язковий) – фільтрування за датою початку. Підтримувані формати: DD.MM.YYYY, DD/MM/YYYY, YYYY-MM-DD.
• end (рядок, необов’язковий) – фільтрування за датою закінчення. Формати такі самі, як і для start.
• filter_by (рядок, необов’язковий) – Тип фільтра: booking_date (за замовчуванням) або created_date.
• flat (логічне значення, необов’язкове) – повертає booked_slots у вигляді плоского масиву бронювань замість згрупованих за ідентифікатором послуги. Корисно для інтеграцій, таких як Zapier, які очікують простий список записів.

Плоска відповідь для інтеграцій:
/wp-json/baza-booking-calendar/v1/slots/?flat=1

Доступні статуси

• у процесі – Очікується підтвердження
• заброньовано – Бронювання підтверджено
• відхилити – Бронювання відхилено
• завершено – Бронювання завершено
• термін дії закінчився – Бронювання, термін дії якого закінчився

Приклади запитів

Усі бронювання:
/wp-json/baza-booking-calendar/v1/slots/

Тільки активні бронювання:
/wp-json/baza-booking-calendar/v1/slots/?status=pending,booked

Завершені та відхилені бронювання на червень 2025 року:
/wp-json/baza-booking-calendar/v1/slots/?status=completed,reject&start=01.06.2025&end=30.06.2025

Усі бронювання в межах певного періоду:
/wp-json/baza-booking-calendar/v1/slots/?start=01/06/2025&end=30/06/2025

Забронювати вільні слоти для певної послуги

Запит:
GET /wp-json/baza-booking-calendar/v1/slots/?service={slug}
GET /wp-json/baza-booking-calendar/v1/slots/?service={ID}

Параметри:

• service (рядок, обов’язкове) – скорочений ідентифікатор або ідентифікатор сервісу (наприклад, massage-therapy, yoga-class, або ID).
• status (рядок, необов’язковий) – Те саме, що й вище.
• start (рядок, необов’язковий параметр) – Дата початку.
• end (рядок, необов’язкове) – Дата закінчення.

Приклади запитів

Усі бронювання послуги масажу:
/wp-json/baza-booking-calendar/v1/slots/?
service=massage-therapy/wp-json/baza-booking-calendar/v1/slots/?service={ID}

Активні бронювання послуги масажу:
/wp-json/baza-booking-calendar/v1/slots/?service=massage-therapy&status=pending,booked

Типові випадки використання

Дізнатися про час, коли система недоступна (неробочі години, вихідні)

Запит:
GET /wp-json/baza-booking-calendar/v1/disabled-time/

Параметри:

• service (рядок, необов’язкове) – скорочений ідентифікатор або ідентифікатор сервісу (наприклад, studio-1 або ID).
• start (рядок, необов’язковий параметр) – Дата початку.
• end (рядок, необов’язкове) – Дата закінчення.

Приклади запитів

Усі заблоковані слоти на найближчі 3 місяці:
/wp-json/baza-booking-calendar/v1/disabled-time/

Для конкретної послуги:
/wp-json/baza-booking-calendar/v1/disabled-time/?
service=studio-1/wp-json/baza-booking-calendar/v1/disabled-time/?service={ID}

Для певного діапазону дат:
/wp-json/baza-booking-calendar/v1/disabled-time/?start=01.12.2025&end=31.12.2025