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" }

Endpoint pubblici

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

/v1/events. Elenca le sessioni prenotabili con i dettagli e la disponibilità dei posti in tempo reale.
/v1/bookings. Crea prenotazioni con una chiave di idempotenza così i nuovi tentativi non generano mai doppie prenotazioni.
/v1/giftcards. Cerca e applica carte regalo nell'ambito di una prenotazione.
/v1/promocodes. Valida un codice promozionale prima del pagamento, con accesso pubblico a frequenza limitata.
/v1/customers. Lavora con le schede cliente collegate tramite e-mail.
/v1/courses. Elenca i corsi in più sessioni, ottieni preventivi e prenota un intero corso con una sola chiamata.
/v1/categories. Leggi le tue categorie di eventi per raggruppare e filtrare ciò che mostri.
/v1/tenant/config. Recupera la configurazione pubblica per rendere correttamente il tuo percorso di prenotazione.
/v1/referrals. Cerca un codice di segnalazione così i clienti segnalati ricevono il credito giusto.
/v1/payments/paypal. Crea e cattura ordini PayPal nell'ambito di una prenotazione.
Specifica OpenAPI 3.1. L'intera API è distribuita come specifica OpenAPI 3.1 completa e scaricabile, da cui puoi generare client tipizzati, con un riferimento interattivo nell'app ed esempi di richiesta e risposta pronti da copiare.

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

Chiama /v1/events per elencare le sessioni prenotabili e la disponibilità dei posti, e valida i codici promozionali prima del pagamento.

Crea prenotazioni

Invia una richiesta a /v1/bookings 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.