Integrazione API (avanzata)
Gli appuntamenti prenotabili possono essere consultati e prenotati direttamente tramite gli endpoint API aperti della Consumer Booking API. Poiché qui sono disponibili solo appuntamenti prenotabili pubblicamente, non è richiesta alcuna autenticazione.
Per integrazioni complete tramite la timum Partner API, contatti il nostro servizio: +49 (0)30 41765984 oppure tramite www.timum.de.
Informazioni di base – importante
Il calendario del fornitore ("Provider") viene indicato tramite il suo UUID: Trovare l'UUID del fornitore
Le risorse prenotabili (consulenti, immobili, oggetti) vengono referenziate tramite identificatori specifici provenienti dai sistemi CRM o tramite UUID timum: Trovare o creare i riferimenti
La prenotazione degli appuntamenti tramite l'API aperta di timum segue una tipica sequenza di richieste:
1. Filtrare i tipi di appuntamento (opzionale)
Facoltativamente, può consultare in anticipo l'elenco dei tipi di appuntamento offerti e filtrare gli appuntamenti disponibili per tipo di appuntamento – utile se desidera specificare fasce orarie specifiche per tipo di appuntamento: endpoint POST list active products
2. Consultare gli appuntamenti prenotabili
Consultare gli appuntamenti prenotabili disponibili: endpoint GET upcoming bookables
3. Prenotare la fascia oraria selezionata
Non appena una cliente o un cliente ha preselezionato un appuntamento, lo prenoti innanzitutto per 3 minuti affinché non possa essere prenotato da qualcun altro durante l'inserimento dei dati del cliente: endpoint POST reserve appointment
4. Prenotare l'appuntamento con i dati del cliente
Dopo aver fornito tutte le informazioni richieste, prenoti l'appuntamento con i dati del cliente: POST create appointment with consumer
Per approfondire
- Incorporare il widget – il modo più semplice, senza integrazione API propria
- Documentazione per sviluppatori