belbo
  • Übersicht
  • API-Referenz
      • Abfrage der Standorte
      • Abfrage der Leistungen und Gruppen
      • Berechnung der Mitarbeiter zu Leistungen
      • Abfrage des Warenkorbs
      • Zusatzdienstleistungen für gewählte Leistungen abfragen
      • Abfrage von zusätzlichen Feldern (deprecated)
      • Mitarbeiterinformationsabfrage
      • Mitarbeitersuche mit Namen
      • Preisdetails für Leistung
      • Schrittweisen Buchungsprozess abfragen
      • Verfügbare Termine
      • Terminzeiten (auch bereits belegte)
      • Buchung starten (alt)
      • Buchung starten
      • Buchungsstatus abfragen
      • Abfrage des Warenkorbs für eine Buchung
      • Kundendaten zur Buchung hinzufügen
      • Abfrage Termin-spezifischer Felder
      • Terminspezifische Informationen speichern
      • Buchungsabschluss
      • Newsletterregistrierung
      • Gutscheinrestwertabfrage
      • Bewertungsabfrage
      • Abfrage der verkaufbaren Gutscheine
      • 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
      • Kundensuche nach Mobilnummer
      • Kundenliste mit Mobilnummer
      • Kundenabfrage
      • Rechnungen abfragen
      • Produktauflistung VK
      • Produktsuche
      • Leistungsauflistung gruppiert nach Produktgruppe
      • Leistungsauflistung
      • Gutscheinauflistung
      • Mitarbeiter
      • Kassenstandsabfrage
      • Bestand an einem Verkaufsprodukt ändern
      • Kundentermin absagen
Skip to content

API-Referenz › Public API › Buchung

Buchung starten (alt)

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

Die „bookAppointment“ Schnittstelle führt eine provisorische Buchung durch. Diese Buchung ist nach Rückgabe noch nicht abgeschlossen. Es wird hier lediglich ein Zeitbereich „reserviert“. Im Ergebnis der Abfrage sind Informationen ernthalten, die für die weitere Buchung notwendig sind. Hierzu gehört ‚appointmentId‘ und ‚appointmentParticipantId‘.

Falls der Termin bereits oder inzwischen vergeben ist, wird folgende Antwort geliefert:

{ „result“: „GIVEN“ }

Parameter

NameÜbergabe
date Body
Platzhalter{{bookingDay}}

dd.MM.yyyy

time Body
Beispiel16:00

HH:mm

selectedProducts Body
Platzhalter{{selectedProducts}}
servicerGroupId Body
Platzhalter{{servicerGroupId}}
bookingSource Body

Frei definierbar, um die Quelle der Buchung zu tracken.

successPage Body

Absolute URL, auf die weitergeleitet werden soll, wenn eine Buchung abgeschlossen wurde.

bookingGroups[0] Body

ID des Mitarbeiters, falls null beliebig

Struktur zuletzt mit der Postman-Collection abgeglichen: 09.09.2026

Beispielantwort

200 Buchung starten
{
    "result": "OK",
    "appointmentId": "cdbd3737fd5e4d524002c2d4721a53f8",
    "appointmentParticipantId": "d75ac49f97b1d6a24c65ac5d74451ca4",
    "url": "/buchung/cdbd3737fd5e4d524002c2d4721a53f8"
}

Hast du eine Frage? Stelle sie hier.

Dieses Handbuch ist ein Service von belbo. Impressum