REST API
Buchung in eigene Systeme integrieren
Ihre Nutzer sollen Termine buchen, ohne Ihre Plattform zu verlassen – unter Ihrer Marke, mit Ihren IDs. Die timum-API deckt den kompletten Lebenszyklus ab: von der Organisationsstruktur bis zur Consumer-Buchung. Es sind exakt die Endpunkte, mit denen das BookingJs-Widget täglich produktiv bucht – über die timum-Infrastruktur wurden bereits 2.000.000+ Teilnehmer koordiniert.
API-Zugang auf Anfrage – in den Jahres-Plänen enthalten. Ein Anruf genügt.
So funktioniert es
API-Key anfordern
Ein Anruf genügt – der API-Zugang ist Teil der Jahres-Pläne. Sie erhalten den Key für den Header X-TIMUM-CLIENT-ID. Er ist an Ihre crmId gebunden, die alle Partner-API-Pfade als Parameter tragen.
Struktur und Angebot anlegen
Initial Setup (Users, Accounts, Providers, Staff), danach Configure Offerings (Objekte, Terminarten, Kontaktprofile).
Buchen lassen
Booking Flow: upcoming_bookables abrufen → reserve_appointment (3-Minuten-Hold) → create_appointment_with_consumer.
Ihre Vorteile
Vollständig programmatisch: Users, Accounts, Provider, Objekte, Terminarten, Timeslots und Buchungen per REST – authentifiziert über den Header X-TIMUM-CLIENT-ID.
Ihre IDs bleiben führend: Das Referenz-Format {uniqueId}@{platformName} erspart das Mapping von Fremdschlüsseln – Sie referenzieren Entitäten mit den IDs Ihres eigenen Systems.
Open Booking API ohne API-Key für Ihr Consumer-Frontend – dieselben Endpunkte wie im Widget, inklusive 3-Minuten-Reservierung.
JSON, CORS, präzise Statuscodes: Ein bereits vergebener Termin antwortet mit 412 Precondition Failed statt mit einer Race Condition – gehostet in Frankfurt.
Wer braucht diese Funktion?
Erfahren Sie, wie diese Funktion verschiedenen Anwendern hilft
Buchung nativ in der eigenen Website
Ihre Agentur baut die Terminauswahl direkt in Ihren Webauftritt – über die Open-Booking-Endpunkte, ohne Widget-Layout und ohne API-Key.
Terminbuchung als Produktfeature
CRM- oder Portal-Anbieter integrieren Terminkoordination unter eigener Marke. timum bleibt für Endkunden unsichtbar; Nutzer kosten nichts, bezahlt wird, was buchbar ist.
Interessentenportal des Bauträgers
Das Projektportal legt je Einheit ein buchbares Objekt an und bucht Besichtigungen per API – die Einheiten-IDs aus dem eigenen System bleiben die Referenz.
Verwandte Funktionen
Bauen Sie Terminbuchung in Ihr Produkt ein
30 Tage kostenlos testen. Keine Kreditkarte erforderlich.