timum

API-Einbindung (fortgeschritten)

Buchbare Termine können über die offenen API-Endpunkte der Consumer Booking API abgefragt und direkt gebucht werden. Da hier nur öffentlich buchbare Termine verfügbar sind, ist keine Authentifizierung erforderlich.

Für vollständige Integrationen über die timum Partner-API wenden Sie sich an unseren Service: +49 (0)30 41765984 oder über www.timum.de.

Basis-Informationen – wichtig

Der Anbieter-Kalender („Provider“) wird über seine UUID angegeben: Provider-UUID finden

Buchbare Ressourcen (Berater, Immobilien, Objekte) werden über spezifische Kennungen aus CRM-Systemen oder über timum-UUIDs referenziert: Referenzen finden oder anlegen

Die Terminbuchung über die offene timum-API erfolgt über eine typische Request-Abfolge:

1. Terminarten filtern (optional)

Optional können Sie vorab die Liste der angebotenen Terminarten abfragen und die verfügbaren Termine nach Terminart filtern – sinnvoll, wenn Sie terminart-spezifische Zeitfenster vorgeben: Endpunkt POST list active products

2. Buchbare Termine abfragen

Freie buchbare Termine abfragen: Endpunkt GET upcoming bookables

3. Ausgewählten Zeitslot reservieren

Sobald eine Kundin oder ein Kunde einen Termin vorausgewählt hat, reservieren Sie diesen zunächst für 3 Minuten, damit er während der Eingabe der Kundendaten nicht von jemand anderem gebucht werden kann: Endpunkt POST reserve appointment

4. Termin mit Kundendaten buchen

Nachdem alle erforderlichen Angaben gemacht wurden, buchen Sie den Termin mit den Kundendaten: POST create appointment with consumer

Weiterführend