GrowFlow Booking espone un'API REST su /api/v1 per integrare disponibilità e prenotazioni direttamente nel tuo prodotto. Ti autentichi con una API key (X-API-Key: bk_live_...) o con un JWT, usi gli SDK ufficiali per Python e Node.js e lavori su tenant, disponibilità, prenotazioni, calendari e crediti. Con i webhook resti aggiornato sugli eventi.
API REST su /api/v1
Auth con API key (bk_live_...) o JWT Bearer
SDK ufficiali Python e Node.js
Endpoint per disponibilità, prenotazioni e calendari
Webhook per gli eventi di prenotazione
Sistema di quote e crediti per integrazioni esterne
L'API di GrowFlow Booking è servita su /api/v1 e copre l'intero flusso di prenotazione: leggere i tenant, interrogare la disponibilità per date e slot, creare prenotazioni semplici o esperienze, gestire i calendari e le quote. È la stessa API che alimenta il widget e la dashboard.
Autenticazione: API key o JWT
Puoi autenticarti in due modi: con una API key passata nell'header X-API-Key (formato bk_live_...), pensata per integrazioni server-to-server e SDK, oppure con un token JWT Bearer per i flussi autenticati. Scegli il meccanismo più adatto al tuo caso d'uso.
SDK ufficiali Python e Node.js
Non devi costruire il client da zero: usa gli SDK ufficiali growflow-booking-client per Python e @growflow/booking-client per Node.js. Espongono metodi tipizzati per leggere gli slot disponibili e creare prenotazioni, così integri Booking in poche righe.
Webhook e sistema di crediti
L'API include i webhook per ricevere gli eventi di prenotazione in tempo reale e un sistema di quote e crediti pensato per le integrazioni esterne: puoi assegnare crediti a un cliente e scalarli a ogni prenotazione, utile quando Booking è il motore dietro un altro prodotto.
Widget e chat sullo stesso motore
Se non vuoi partire dall'API, il widget embeddabile ti dà una UI pronta sullo stesso backend: guarda il widget di prenotazione. E per un'esperienza conversazionale, le prenotazioni via chat usano queste stesse API. Tutti i dettagli tecnici sono nella pagina per sviluppatori.
L'API REST è servita su /api/v1 e copre tenant, disponibilità (date e slot), prenotazioni semplici ed esperienze, calendari e quote. È la stessa API che alimenta il widget e la dashboard.
Come funziona l'autenticazione?
In due modi: una API key nell'header X-API-Key (formato bk_live_...), ideale per integrazioni server-to-server e SDK, oppure un token JWT Bearer. Scegli il meccanismo più adatto al tuo caso d'uso.
Ci sono SDK ufficiali?
Sì: growflow-booking-client per Python e @growflow/booking-client per Node.js. Espongono metodi tipizzati per leggere gli slot disponibili e creare prenotazioni senza costruire il client a mano.
Sono disponibili i webhook?
Sì. L'API include i webhook per ricevere gli eventi di prenotazione in tempo reale, così puoi tenere sincronizzato il tuo sistema con quanto accade su Booking.
Cos'è il sistema di crediti?
È un sistema di quote e crediti per le integrazioni esterne: assegni crediti a un cliente e li scali a ogni prenotazione. È utile quando Booking fa da motore di prenotazione dietro un altro prodotto.
Integra le prenotazioni via API
Crea il tuo account, genera una API key e inizia a integrare disponibilità e prenotazioni con gli SDK ufficiali.