API REST
Integra la prenotazione nei tuoi sistemi
I vostri utenti devono poter prenotare senza lasciare la vostra piattaforma: con il vostro brand e i vostri identificativi. L'API di timum copre l'intero ciclo di vita, dalla struttura organizzativa alla prenotazione del consumatore. Sono esattamente gli endpoint con cui il widget BookingJs prenota ogni giorno in produzione: sull'infrastruttura timum sono già stati coordinati oltre 2.000.000 di partecipanti.
Accesso API su richiesta – incluso nei piani annuali. Basta una telefonata.
Come funziona
Richiedere la chiave API
Basta una telefonata – l'accesso API fa parte dei piani annuali. Ricevete la chiave per l'header X-TIMUM-CLIENT-ID. È legata al vostro crmId, che tutti i percorsi della Partner API portano come parametro.
Creare struttura e offerta
Initial Setup (users, accounts, providers, staff), poi Configure Offerings (immobili, tipi di appuntamento, profili di contatto).
Far prenotare
Booking Flow: chiamare upcoming_bookables → reserve_appointment (blocco di 3 minuti) → create_appointment_with_consumer.
I tuoi vantaggi
Completamente programmatico: users, accounts, providers, immobili, tipi di appuntamento, timeslots e prenotazioni via REST, con autenticazione tramite l'header X-TIMUM-CLIENT-ID.
I vostri identificativi restano quelli di riferimento: il formato {uniqueId}@{platformName} evita il mapping di chiavi esterne; referenziate le entità con gli ID del vostro sistema.
Open Booking API senza chiave API per il vostro frontend consumer: gli stessi endpoint del widget, prenotazione di 3 minuti inclusa.
JSON, CORS e codici di stato precisi: un appuntamento già assegnato risponde con 412 Precondition Failed invece di una race condition, con hosting a Francoforte.
Chi ha bisogno di questa funzionalità?
Scopri come questa funzionalità aiuta diversi utenti
Prenotazione nativa nel proprio sito
La vostra agenzia integra la scelta degli orari direttamente nel sito, tramite gli endpoint Open Booking, senza il layout del widget e senza chiave API.
La prenotazione come funzione di prodotto
I fornitori di CRM o di portali integrano il coordinamento degli appuntamenti con il proprio brand. timum resta invisibile per il cliente finale; gli utenti non costano nulla, si paga ciò che è prenotabile.
Il portale interessati del promotore immobiliare
Il portale di progetto crea un immobile prenotabile per ogni unità e prenota le visite via API: gli ID delle unità del proprio sistema restano il riferimento.
Funzionalità correlate
Porta la prenotazione appuntamenti nel tuo prodotto
Prova gratis per 30 giorni. Nessuna carta di credito richiesta.