API REST

Intégrez la réservation dans vos propres systèmes

Vos utilisateurs doivent pouvoir réserver sans quitter votre plateforme – sous votre marque, avec vos identifiants. L'API timum couvre l'ensemble du cycle de vie : de la structure organisationnelle à la réservation par le consommateur. Ce sont exactement les endpoints avec lesquels le widget BookingJs réserve chaque jour en production – plus de 2 000 000 de participants ont déjà été coordonnés via l'infrastructure timum.

À partir de quel forfait ?Dans chaque forfait

Accès API sur demande – inclus dans les forfaits annuels. Un appel suffit.

Comment ça fonctionne

1

Demander une clé API

Un appel suffit – l'accès API fait partie des forfaits annuels. Vous recevez la clé pour l'en-tête X-TIMUM-CLIENT-ID. Elle est liée à votre crmId, que tous les chemins de la Partner API portent en paramètre.

2

Créer la structure et l'offre

Initial Setup (users, accounts, providers, staff), puis Configure Offerings (biens, types de rendez-vous, profils de contact).

3

Laisser réserver

Booking Flow : appeler upcoming_bookables → reserve_appointment (blocage de 3 minutes) → create_appointment_with_consumer.

Vos avantages

Entièrement programmatique : users, accounts, providers, biens, types de rendez-vous, timeslots et réservations via REST – authentification par l'en-tête X-TIMUM-CLIENT-ID.

Vos identifiants restent la référence : le format {uniqueId}@{platformName} évite le mapping de clés étrangères – vous référencez les entités avec les identifiants de votre propre système.

Open Booking API sans clé API pour votre frontend consommateur – les mêmes endpoints que dans le widget, réservation de 3 minutes comprise.

JSON, CORS, codes de statut précis : un rendez-vous déjà attribué répond 412 Precondition Failed au lieu d'une race condition – hébergé à Francfort.

Qui a besoin de cette fonctionnalité ?

Découvrez comment cette fonctionnalité aide différents utilisateurs

Einzelmakler

La réservation nativement dans votre site

Votre agence intègre le choix des créneaux directement dans votre site – via les endpoints Open Booking, sans la mise en page du widget et sans clé API.

Maklerbüro

La prise de rendez-vous comme fonctionnalité produit

Les éditeurs de CRM ou de portails intègrent la coordination de rendez-vous sous leur propre marque. timum reste invisible pour le client final ; les utilisateurs ne coûtent rien, on paie ce qui est réservable.

Bauträger

Le portail intéressés du promoteur

Le portail du programme crée un bien réservable par logement et réserve les visites via l'API – les identifiants de logement de son propre système restent la référence.

Intégrez la prise de rendez-vous à votre produit

Testez gratuitement pendant 30 jours. Aucune carte de crédit requise.