REST API

Prehľad

Tento plugin poskytuje rozšírené rozhranie REST API pre programový prístup k údajom o rezerváciách.
Toto rozhranie podporuje pokročilé filtrovanie a vráti všetky stavy rezervácií s flexibilným filtrovaním podľa dátumového rozsahu.

Základná URL adresa:
/wp-json/baza-booking-calendar/v1/

Koncové body

Zobraziť všetky rezervované termíny pomocou filtrov

Požiadavka:
GET /wp-json/baza-booking-calendar/v1/slots/

Parametre dotazu:

• status (reťazec, voliteľné) – Filtrovanie podľa stavu rezervácie. Podporuje jeden stav alebo viacero hodnôt oddelených čiarkami.
• start (reťazec, voliteľné) – Filtrovanie podľa dátumu začiatku. Podporované formáty: DD.MM.YYYY, DD/MM/YYYY, YYYY-MM-DD.
• end (reťazec, voliteľné) – Filtrovanie podľa dátumu ukončenia. Formáty sú rovnaké ako pri start.
• filter_by (reťazec, voliteľné) – Typ filtra: booking_date (predvolené) alebo created_date.
• flat (boolean, voliteľné) – Vráti booked_slots ako ploché pole rezervácií namiesto zoskupenia podľa ID služby. Užitočné pre integrácie, ako je napríklad Zapier, ktoré očakávajú jednoduchý zoznam záznamov.

Plochá odpoveď pre integrácie:
/wp-json/baza-booking-calendar/v1/slots/?flat=1

Dostupné stavy

• v riešení – Čaká sa na potvrdenie
• rezervované – Potvrdená rezervácia
• zamietnuť – Zamietnutá rezervácia
• vybavené – Rezervácia bola vybavená
• vypršala platnosť – Rezervácia s vypršanou platnosťou

Príklady požiadaviek

Všetky rezervácie:
/wp-json/baza-booking-calendar/v1/slots/

Iba aktívne rezervácie:
/wp-json/baza-booking-calendar/v1/slots/?status=pending,booked

Ukončené a zamietnuté rezervácie na jún 2025:
/wp-json/baza-booking-calendar/v1/slots/?status=completed,reject&start=01.06.2025&end=30.06.2025

Všetky rezervácie v určitom časovom období:
/wp-json/baza-booking-calendar/v1/slots/?start=01/06/2025&end=30/06/2025

Zarezervujte si termíny pre konkrétnu službu

Požiadavka:
GET /wp-json/baza-booking-calendar/v1/slots/?service={slug}
GET /wp-json/baza-booking-calendar/v1/slots/?service={ID}

Parametre:

• služba (reťazec, povinné) – skratka alebo ID služby (napr. massage-therapy, yoga-class, alebo ID).
• status (reťazec, voliteľné) – To isté ako vyššie.
• start (reťazec, nepovinné) – Dátum začiatku.
• end (reťazec, voliteľné) – Dátum ukončenia.

Príklady požiadaviek

Všetky rezervácie masážnych služieb:
/wp-json/baza-booking-calendar/v1/slots/?
service=massage-therapy/wp-json/baza-booking-calendar/v1/slots/?service={ID}

Aktívne rezervácie masážnych služieb:
/wp-json/baza-booking-calendar/v1/slots/?service=massage-therapy&status=pending,booked

Bežné prípady použitia

Zistiť časy, kedy je služba nedostupná (mimo pracovnej doby, voľné dni)

Požiadavka:
GET /wp-json/baza-booking-calendar/v1/disabled-time/

Parametre:

• služba (reťazec, voliteľné) – skrátený názov alebo ID služby (napr. studio-1 alebo ID).
• start (reťazec, voliteľné) – Dátum začiatku.
• end (reťazec, nepovinné) – Dátum ukončenia.

Príklady požiadaviek

Všetky zablokované termíny na najbližšie 3 mesiace:
/wp-json/baza-booking-calendar/v1/disabled-time/

Pre konkrétnu službu:
/wp-json/baza-booking-calendar/v1/disabled-time/?
service=studio-1/wp-json/baza-booking-calendar/v1/disabled-time/?service={ID}

Pre konkrétne časové obdobie:
/wp-json/baza-booking-calendar/v1/disabled-time/?start=01.12.2025&end=31.12.2025