API per sviluppatori

Inizia semplice, poi integra in profondità.

Parti dalla pagina ospitata per andare veloce, integra il widget per rispettare il design del tuo sito, oppure costruisci un percorso completamente su misura sull'API REST pubblica, con chiavi ad ambito limitato, prenotazione idempotente e una specifica OpenAPI 3.1 pubblicata.

Inizia ora Vedi il widget di prenotazione

Ideale per: sviluppatori che costruiscono un'esperienza di prenotazione su misura (la tua interfaccia, la tua logica) sopra lo stesso motore della pagina ospitata e del 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 costruire, un solo motore di prenotazione.

Non tutte le attività hanno bisogno dello stesso livello di controllo, e non dovresti dover scegliere subito. La pagina ospitata ti manda online in fretta, il widget porta la prenotazione dentro il design del tuo sito, e l'API c'è quando ti serve un'esperienza completamente su misura.

Tutti e tre girano sullo stesso motore, quindi blocco dei posti, pagamenti, liberatorie e conferme si comportano allo stesso modo qualunque cosa tu scelga. Inizia semplice e passa all'API quando il tuo prodotto ha bisogno di logica su misura, senza migrazioni di mezzo.

# Crea una prenotazione POST /v1/bookings Authorization: Bearer sk_... { "event_id": "evt_8KQ2", "seats": 2 } -> 201 Created { "id": "bkg_5X9", "status": "confirmed" }

Cosa copre l'API

L'API REST su cui si basa il tuo percorso di prenotazione.

Sessioni e disponibilità. Leggi il tuo calendario con la disponibilità dei posti in tempo reale, così la tua interfaccia mostra esattamente cosa è prenotabile in questo momento.
Prenotazioni. Crea, leggi e annulla prenotazioni, con una chiave di idempotenza così una connessione interrotta non diventa mai un duplicato.
Pagamento. Valida i codici promozionali, cerca e applica le carte regalo ed esegui i passaggi di pagamento legati a una prenotazione.
Corsi. Elenca i corsi in più sessioni, ottieni un preventivo e prenota un intero corso con una sola chiamata.
Clienti e passaparola. Lavora con le schede cliente collegate tramite e-mail e cerca un codice di segnalazione così il credito arriva nel posto giusto.
Configurazione. Recupera le impostazioni pubbliche e le categorie di cui il tuo percorso di prenotazione ha bisogno per mostrarsi correttamente.
Una specifica pubblicata. L'intera API è distribuita come specifica OpenAPI 3.1 completa e scaricabile da cui puoi generare client tipizzati, con un riferimento interattivo nell'applicazione ed esempi di richieste e risposte da copiare e incollare.

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, autorizzalo una volta e chiedi del tuo studio in linguaggio naturale.
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 sta arrivando, quanto si riempie ogni sessione e quali lezioni reggono il tuo tasso di riempimento.
Cosa serve promuovere. Estrai le sessioni sotto la metà, dalle più vuote, finché c'è ancora tempo per intervenire.
Prenotazioni, ricavi e presenze. Il numero di prenotazioni con annullamenti e pagamenti falliti distinti, i ricavi di lezioni, carte regalo ed eventi privati, e se chi ha prenotato si è 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.
Le avvertenze viaggiano con i numeri. 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

Pensato per la produzione fin dalla prima richiesta.

Chiavi pubbliche e segrete. Inserisci le chiavi pubbliche pk_ nel browser e tieni le chiavi segrete sk_ lato server per l'accesso completo.
Ambiti sulle chiavi pubbliche. Concedi a una chiave del browser solo l'accesso che serve, come sfogliare gli eventi o controllare i saldi delle carte regalo, e nulla di più.
Controllo dell'origine per le chiavi pubbliche. Aggiungi origini consentite a una chiave pubblica e le richieste che portano un Origin del browser dovranno corrispondere, così una chiave non può essere riusata da un altro sito.
Scadenza, revoca e modifica. Dai a una chiave una data di scadenza facoltativa, revocala all'istante oppure aggiornane nome, ambiti e origini man mano che la tua integrazione cambia.
Segreti memorizzati con hash. La chiave grezza viene mostrata una sola volta alla creazione; viene salvato solo un hash, così 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 e contro gli abusi.
Chiavi di idempotenza sulla prenotazione. Nuovi tentativi sicuri: una connessione caduta non diventa mai una prenotazione doppia.
Lo stesso motore sotto. Blocco dei posti, pagamenti, liberatorie e conferme corrispondono esattamente alla pagina ospitata e al widget.

Come funziona

Dalla prima chiamata al percorso su misura in produzione.

Crea le tue chiavi

Genera chiavi pubbliche e segrete, imposta gli ambiti sulle chiavi pubbliche e aggiungi le origini consentite così le richieste dal browser vengono controllate.

Leggi il calendario

Leggi le sessioni prenotabili e la disponibilità dei loro posti, e valida i codici promozionali prima del pagamento.

Crea prenotazioni

Invia la prenotazione con una chiave di idempotenza. I posti si bloccano durante il pagamento e l'incasso viene catturato.

Pubblica la tua esperienza su misura

Costruisci l'interfaccia che vuoi sopra l'API, usando gli endpoint documentati e gli esempi dell'SDK per andare veloce.