timum

Intégration API (avancée)

Les rendez-vous réservables peuvent être consultés et réservés directement via les endpoints API ouverts de la Consumer Booking API. Comme seuls les rendez-vous réservables publiquement sont disponibles ici, aucune authentification n'est requise.

Pour des intégrations complètes via la timum Partner API, veuillez contacter notre service : +49 (0)30 41765984 ou via www.timum.de.

Informations de base – important

Le calendrier du fournisseur (« Provider ») est indiqué via son UUID : Trouver l'UUID du fournisseur

Les ressources réservables (conseillers, biens immobiliers, objets) sont référencées via des identifiants spécifiques provenant des systèmes CRM ou via des UUID timum : Trouver ou créer des références

La réservation de rendez-vous via l'API ouverte de timum suit une séquence de requêtes typique :

1. Filtrer les types de rendez-vous (facultatif)

Vous pouvez, en option, consulter au préalable la liste des types de rendez-vous proposés et filtrer les rendez-vous disponibles par type de rendez-vous – utile si vous souhaitez définir des plages horaires spécifiques à un type de rendez-vous : endpoint POST list active products

2. Consulter les rendez-vous réservables

Consulter les rendez-vous réservables disponibles : endpoint GET upcoming bookables

3. Réserver le créneau horaire sélectionné

Dès qu'une cliente ou un client a présélectionné un rendez-vous, réservez-le d'abord pendant 3 minutes afin qu'il ne puisse pas être réservé par quelqu'un d'autre pendant la saisie des données du client : endpoint POST reserve appointment

4. Réserver le rendez-vous avec les données du client

Une fois toutes les informations requises fournies, réservez le rendez-vous avec les données du client : POST create appointment with consumer

Pour aller plus loin