REST-API

Übersicht

Das Plugin bietet eine erweiterte REST-API für den programmgesteuerten Zugriff auf Buchungsdaten.
Die API unterstützt erweiterte Filterfunktionen und liefert alle Buchungsstatus mit flexiblen Filteroptionen für den Datumsbereich.

Basis-URL:
/wp-json/baza-booking-calendar/v1/

Endpunkte

Alle gebuchten Termine mit Filtern anzeigen

Anfrage:
GET /wp-json/baza-booking-calendar/v1/slots/

Abfrageparameter:

• Status (Zeichenkette, optional) – Nach Buchungsstatus filtern. Es kann ein einzelner Status oder mehrere durch Kommas getrennte Werte angegeben werden.
• start (Zeichenkette, optional) – Nach Startdatum filtern. Unterstützte Formate: DD.MM.YYYY, DD/MM/YYYY, YYYY-MM-DD.
• end (Zeichenkette, optional) – Nach Enddatum filtern. Gleiche Formate wie bei start.
• filter_by (Zeichenkette, optional) – Filtertyp: booking_date (Standard) oder created_date.
• flat (boolesch, optional) – Gibt booked_slots ein flaches Array mit Buchungen anstelle einer Gruppierung nach Service-ID. Nützlich für Integrationen wie Zapier, die eine einfache Liste von Datensätzen erwarten.

Flache Antwort für Integrationen:
/wp-json/baza-booking-calendar/v1/slots/?flat=1

Verfügbare Status

• in Bearbeitung – Warten auf Bestätigung
• gebucht – Bestätigte Buchung
• ablehnen – Abgelehnte Buchung
• abgeschlossen – Buchung abgeschlossen
• abgelaufen – Abgelaufene Buchung

Beispiele für Anfragen

Alle Buchungen:
/wp-json/baza-booking-calendar/v1/slots/

Nur aktive Buchungen:
/wp-json/baza-booking-calendar/v1/slots/?status=pending,booked

Abgeschlossene und abgelehnte Buchungen für Juni 2025:
/wp-json/baza-booking-calendar/v1/slots/?status=completed,reject&start=01.06.2025&end=30.06.2025

Alle Buchungen innerhalb eines bestimmten Zeitraums:
/wp-json/baza-booking-calendar/v1/slots/?start=01.06.2025&end=30.06.2025

Termine für eine bestimmte Dienstleistung buchen

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

Parameter:

• service (Zeichenkette, erforderlich) – Service-Slug oder -ID (z. B. massage-therapy, yoga-classoder ID).
• status (Zeichenkette, optional) – Wie oben.
• start (Zeichenkette, optional) – Startdatum.
• end (Zeichenkette, optional) – Enddatum.

Beispiele für Anfragen

Alle Buchungen für den Massageservice:
/wp-json/baza-booking-calendar/v1/slots/?
service=massage-therapy/wp-json/baza-booking-calendar/v1/slots/?service={ID}

Aktuelle Buchungen für den Massageservice:
/wp-json/baza-booking-calendar/v1/slots/?service=massage-therapy&status=pending,booked

Häufige Anwendungsfälle

Ausfallzeiten abrufen (Arbeitsfreie Zeiten, freie Tage)

Anfrage:
GET /wp-json/baza-booking-calendar/v1/disabled-time/

Parameter:

• service (Zeichenkette, optional) – Service-Slug oder -ID (z. B. studio-1 oder ID).
• start (Zeichenkette, optional) – Startdatum.
• end (Zeichenkette, optional) – Enddatum.

Beispiele für Anfragen

Alle gesperrten Termine für die nächsten 3 Monate:
/wp-json/baza-booking-calendar/v1/disabled-time/

Für einen bestimmten Dienst:
/wp-json/baza-booking-calendar/v1/disabled-time/?
service=studio-1/wp-json/baza-booking-calendar/v1/disabled-time/?service={ID}

Für einen bestimmten Zeitraum:
/wp-json/baza-booking-calendar/v1/disabled-time/?start=01.12.2025&end=31.12.2025