API per sviluppatori

Costruisci il tuo checkout sulla nostra API di prenotazione.

La pagina ospitata non richiede codice, e il widget poche righe. Quando vuoi schermate di prenotazione tutte tue, c'è l'API REST pubblica. Il tuo sviluppatore parte da una specifica OpenAPI 3.1 pubblicata, e le chiamate di prenotazione si possono ritentare in sicurezza.

Inizia ora Vedi il widget di prenotazione

Ideale per: sviluppatori che costruiscono schermate e logica di prenotazione proprie. Sotto c'è lo stesso sistema di prenotazione che fa girare la pagina ospitata e il widget.

Scegli la tua integrazione

3 modi

Pagina di prenotazione ospitata, senza codice

Widget integrato, poche righe

API REST pubblica✓

Cosa risolve

Tre modi per ricevere prenotazioni, un solo sistema dietro.

Non devi decidere subito. La pagina ospitata ti mette online oggi, e il widget porta la prenotazione dentro il tuo sito. L'API è per quando vuoi progettare ogni schermata da solo.

Tutti e tre incassano i pagamenti, raccolgono le liberatorie e inviano le conferme allo stesso modo. Così puoi partire dalla pagina ospitata e usare l'API più avanti senza migrare niente.

# Create a booking
POST /v1/bookings
Authorization: Bearer sk_...
Idempotency-Key: order_1042

{
  "event_id": "evt_01K5W3JQ8C9T2N4R7VXHFGMB6D",
  "seat_count": 2,
  "email": "[email protected]",
  "first_name": "Jane",
  "last_name": "Smith",
  "payment_source_id": "pm_..."
}

-> 201 Created
{
  "id": "bkg_01K5W4B2ZQ6M8P3T1YNC7RDXAE",
  "booking_number": "7Q4M2X",
  "status": "confirmed"
}

Cosa copre l'API

Tutto ciò con cui una schermata di prenotazione deve parlare.

Eventi e disponibilità. Leggi il tuo calendario con i posti in tempo reale, così il tuo front end offre solo ciò che si può davvero prenotare in quel momento.
Prenotazioni. Crea, leggi e cancella prenotazioni. Invia una chiave di idempotenza e un nuovo tentativo dopo una connessione caduta non prenoterà due volte. Cerca una prenotazione per numero per mostrarla sulla tua pagina di ringraziamento.
Checkout. Verifica un codice promozionale, cerca una carta regalo e applicala, e gestisci i passaggi di pagamento di una prenotazione.
Corsi. Elenca i corsi in più sessioni per categoria, calcola un prezzo e prenota l'intero corso con una sola chiamata. L'acquisto si rilegge come un unico record con dentro tutte le sessioni.
Clienti e referral. Lavora con schede clienti abbinate per e-mail e cerca un link referral, così il merito va alla persona giusta.
Configurazione. Recupera le impostazioni pubbliche e le categorie che servono alle tue schermate di prenotazione.
Webhook firmati. Il tuo server lo sa nel momento in cui una prenotazione viene creata, modificata, cancellata o registrata al check-in, un pagamento viene incassato o rimborsato, o viene offerto un posto dalla lista d'attesa. Ogni invio è firmato così puoi provare che viene da noi, e uno non riuscito viene ritentato.
Una specifica pubblicata. Scarica la specifica OpenAPI 3.1 completa e genera da lì client tipizzati. L'app ha un riferimento interattivo con esempi di richieste e risposte da copiare.

Assistenti IA

Chiedi a un assistente IA come va il tuo studio.

Collega Claude o ChatGPT in un paio di clic. Aggiungi FullClass come connettore, approvalo una volta, poi chiedi "quanto è pieno sabato?" o "quanto abbiamo incassato a marzo?"
Sola lettura, sempre. Niente su questo endpoint prenota, annulla, rimborsa o invia e-mail. Risponde alle domande e basta.
Il tuo calendario e quanto è pieno. Chiedi cosa c'è in programma, quanto è piena ogni sessione e com'è il tuo tasso di riempimento lezione per lezione o mese per mese.
Cosa serve promuovere. Estrai le sessioni sotto la metà dei posti, dalle più vuote, finché c'è ancora tempo per intervenire.
Prenotazioni, incassi e affluenza. Il numero di prenotazioni, con cancellazioni e pagamenti non riusciti mostrati a parte. I ricavi da lezioni, carte regalo ed eventi privati. E se chi ha prenotato si è davvero presentato.
Nessun dato dei clienti esce. Conteggi dei posti, mai nomi, e-mail o numeri di telefono. Nessun registro dei pagamenti e nessun link di accesso alle lezioni online.
I numeri arrivano con le loro avvertenze. Ogni risposta indica il fuso orario in cui è stata calcolata e gli importi portano le proprie note contabili, così un totale è più difficile da citare fuori contesto.
Oppure collega i tuoi strumenti. È un endpoint Model Context Protocol standard su HTTPS, quindi anche altri client MCP possono collegarsi, autenticandosi con una chiave segreta che hai già.

Chiavi e sicurezza

Una chiave pubblica che puoi mettere tranquillamente su un sito pubblico.

Chiavi pubbliche e segrete. Metti le chiavi pubbliche pk_ nel browser. Tieni le chiavi segrete sk_ sul tuo server per l'accesso completo.
Ambiti sulle chiavi pubbliche. Una chiave del browser riceve solo ciò che le serve, come sfogliare gli eventi o controllare il saldo di una carta regalo.
Controllo dell'origine per le chiavi pubbliche. Elenca i siti a cui appartiene una chiave pubblica. Ogni richiesta con un'Origin del browser deve corrispondere, così nessuno può prendere la chiave e usarla su un altro sito.
Scadenza, revoca e modifica. Imposta una data di scadenza se vuoi, revoca una chiave all'istante, o cambiane nome, ambiti e origini man mano che la tua integrazione cambia.
Segreti conservati come hash. Vedi la chiave completa una volta sola, quando la crei. Conserviamo solo un hash, quindi un database trafugato non espone mai una chiave utilizzabile.
Limiti di frequenza. Le richieste hanno una frequenza limitata per mantenere l'API stabile sotto carico intenso o in caso di abusi.

Come funziona

Dalla prima chiave a un checkout attivo.

Crea le tue chiavi

Crea una chiave pubblica e una chiave segreta. Limita cosa può fare la chiave pubblica e quali siti possono usarla.

Leggi il calendario

Recupera le sessioni prenotabili e quanti posti restano in ognuna. Verifica i codici promozionali prima del pagamento.

Crea prenotazioni

Invia la prenotazione con una chiave di idempotenza e il pagamento viene incassato. Se attivi il blocco dei posti al checkout, i posti restano bloccati mentre il cliente completa il pagamento.

Il resto costruiscilo a modo tuo

Progetta sopra le schermate che vuoi, partendo dagli endpoint documentati e dagli esempi dell'SDK.

Non devi partire dall'API.

Vai online oggi con la pagina di prenotazione ospitata, inserisci il widget di prenotazione nel tuo sito e passa all'API quando vuoi un pagamento tutto tuo. Prenotazioni e dati restano dove sono, quindi non c'è niente da migrare.

Continua a esplorare

Funzionalità correlate

Inizia oggi stesso

Costruisci le prenotazioni a modo tuo.

Parti oggi con la pagina ospitata e passa all'API quando il tuo progetto è pronto.

Inizia ora Accedi

Prova gratuita di 30 giorni · Disdici quando vuoi