belbo
  • Übersicht
  • API-Referenz
      • Abfrage der Standorte
      • Buchbare Standorte
      • Abfrage der Leistungen und Gruppen
      • Berechnung der Mitarbeiter zu Leistungen
      • Buchbare Mitarbeiter
      • Online buchbare Mitarbeiter eines Standorts
      • Abfrage des Warenkorbs
      • Zusatzdienstleistungen für gewählte Leistungen abfragen
      • Globale Zusatzleistungen abfragen
      • Abfrage von zusätzlichen Feldern (deprecated)
      • Mitarbeiterinformationsabfrage
      • Mitarbeitersuche mit Namen
      • Preisdetails für Leistung
      • Schrittweisen Buchungsprozess abfragen
      • Online verkaufbare Abos abfragen
      • Verfügbare Termine
      • Verfügbare Termine (JSON-Body)
      • Terminzeiten (auch bereits belegte)
      • Terminzeiten (JSON-Body)
      • Terminzeiten für mehrere Tage
      • Buchung starten (alt)
      • Buchung starten
      • Termin in einem Schritt buchen
      • Buchungsstatus abfragen
      • Abfrage des Warenkorbs für eine Buchung
      • Kundendaten zur Buchung hinzufügen
      • Abfrage Termin-spezifischer Felder
      • Terminspezifische Informationen speichern
      • Buchungsabschluss
      • Kurse abfragen
      • Kursplatz reservieren
      • Newsletterregistrierung
      • Gutscheinrestwertabfrage
      • Bewertungsabfrage
      • Abfrage der verkaufbaren Gutscheine
      • Automatische Online-Gutscheine abfragen
      • Token erhalten
      • Token auslesen
      • Sprache ändern
      • News
      • Standorte
      • Login
      • Login SHA-2
      • Logout
      • Fragenkatalog auslesen
      • Fragenkatalog auslesen mit Infos
      • Übergreifenden Fragenkatalog auslesen
      • Simple Registrierung
      • Registrierung
      • Registrierung bestätigen (optional)
      • Passwort vergessen
      • Passwort neu setzen (optional)
      • Push ID speichern
      • Passwort ändern
      • Benachrichtigungseinstellungen abfragen
      • Benachrichtigungseinstellungen ändern
      • Zukünftige Terminliste
      • Vergangene Termine
      • Termin absagen
      • Account löschen
      • Profilabfrage
      • Profiländerung
      • Mitarbeiter für Leistungen (deprecated)
      • Mitarbeiter für Leistungen
      • Verfügbare Tage
      • Tagesabfrage
      • Terminzeiten für einen Tag (deprecated)
      • Terminzeiten für einen Tag
      • Uhrzeit reservieren
      • Buchung abschließen
      • Arbeitszeiten abfragen
      • Arbeitszeiten erstellen
      • Arbeitszeiten ändern
      • Arbeitszeiten löschen
      • Arbeitszeiten, Abwesenheiten und Notizen eines Mitarbeiters abrufen
      • Mitarbeiter mit Pause blockieren
      • Terminänderung eines Tages abfragen
      • Termine für einen Tag abfragen
      • Daten für einen einzelnen Termin abfragen
      • Termine für einen Kunden abfragen
      • Kundentermin absagen
      • Mitarbeiter eines Termins ändern
      • Kundendaten zur Buchung hinzufügen (Geschützte API)
      • Rechnungen abfragen
      • Produktauflistung VK
      • Produktsuche
      • Leistungsauflistung gruppiert nach Produktgruppe
      • Leistungsauflistung
      • Gutscheinauflistung
      • Kassenstandsabfrage
      • Bestand an einem Verkaufsprodukt ändern
      • Kundensuche nach Mobilnummer
      • Kundenliste mit Mobilnummer
      • Kundenabfrage
      • Mitarbeiter
      • Kundendaten ändern
      • Zusatzfelder abfragen
Skip to content

API-Referenz › Public API › Abfrage verfügbarer Uhrzeiten

Verfügbare Termine (JSON-Body)

POST https://…/externalBooking/calcAvailableAppointments2
Diese Schnittstelle gehört zur Public API und liefert öffentlich sichtbare Daten – ein API-Schlüssel ist nicht nötig.

Diese Schnittstelle liefert die verfügbaren Uhrzeiten wie Verfügbare Termine (calcAvailableAppointments), erwartet die Daten aber als JSON-Body mit Content-Type: application/json statt als Formulardaten.

Es gibt zwei inhaltliche Unterschiede zur Formular-Variante:

  • Jede Leistung einzeln: Die Leistungen aus selectedProductIds werden nicht als gemeinsame Buchung, sondern jeweils für sich berechnet. Die Antwort enthält deshalb je Leistungs-ID einen eigenen Block im selben Format wie bei calcAvailableAppointments. Für die freien Zeiten einer Kombination mehrerer Leistungen verwenden Sie die Formular-Variante.
  • Kein Mitarbeiter wählbar: bookingGroups wird nicht ausgewertet; berechnet wird immer für einen beliebigen Mitarbeiter.

Ist eine der Leistungen nicht buchbar, bricht der Aufruf ab und liefert dieselbe Fehlerantwort wie calcAvailableAppointments. Ein ungültiger Standort ergibt Status 404 mit {"invalid":true}, fehlende Leistungs-IDs Status 400 mit derselben Antwort.

Header

NameWert
Content-Type application/json

Request-Body (JSON)

Pflichtfelder

FeldTyp
servicerGroupId Zahl
Beispiel16 ID des Standorts, für den die freien Uhrzeiten berechnet werden.
selectedProductIds Liste
Beispiel[180612] IDs der Leistungen als Liste, aus der Leistungsabfrage (calcGroups). Jede Leistung wird einzeln berechnet.
offset Text
Beispiel02.01.2019 Erster Tag des abgefragten Zeitraums im Format TT.MM.JJJJ.

Optionale Felder

FeldTyp
numberOfDays Zahl
Beispiel1 Anzahl der Tage ab "offset", für die verfügbare Uhrzeiten berechnet werden. Standard: 35 Tage.
bookingSource Text
BeispielYour API Freier Text, der die Herkunft der Anfrage kennzeichnet – zum Beispiel der Name Ihrer Anwendung. Sinnvollerweise derselbe Wert, der später bei der eigentlichen Buchung mitgeschickt wird.
Vollständiger Beispiel-Body
{
    "servicerGroupId": 16,
    "selectedProductIds": [
        180612
    ],
    "numberOfDays": 1,
    "offset": "02.01.2019",
    "bookingSource": "Your API"
}

Beispielantwort

200 Verfügbare Termine je Leistung
{
    "180612": {
        "generalAvailabilities": {
            "02.01.2019": [
                {
                    "startDate": "09:00",
                    "realDate": "02.01.201909:00",
                    "differentServicers": [
                        7473
                    ],
                    "hightlightClass": null,
                    "possibleServicers": null,
                    "filtered": false,
                    "rating": 0
                },
                {
                    "startDate": "16:00",
                    "realDate": "02.01.201916:00",
                    "differentServicers": [
                        7473
                    ],
                    "hightlightClass": null,
                    "possibleServicers": null,
                    "filtered": false,
                    "rating": 0
                }
            ]
        }
    }
}

Hast du eine Frage? Stelle sie hier.

Dieses Handbuch ist ein Service von belbo. Impressum