API di prenotazione

L'API di prenotazione per il tuo prodotto

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

Un'API REST completa

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.

Approfondisci: la pagina per sviluppatori · il widget di prenotazione

Domande frequenti

Dove si trova l'API di prenotazione?
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.

Crea il tuo account gratis