Puoi mantenere il sito del professionista e realizzare la pagina di prenotazione con la tua grafica. Le API usano lo stesso catalogo e la stessa agenda di Slotix, compresi controlli su professionisti, sale, attrezzature e capienza dei corsi.
https://www.studio.it). Ogni variante, compresa www, va autorizzata esplicitamente.dott-rossi, identifica la pagina; non è una credenziale.Per il collegamento dal server del professionista puoi usare le stesse API pubbliche: CORS riguarda solo i browser. I siti autorizzati possono chiamare esclusivamente le API pubbliche; non acquisiscono accesso al gestionale. L’API deve essere raggiungibile in HTTPS. Per sviluppo su localhost è ammesso HTTP.
import { SlotixBooking } from './slotix-booking.js';
const slotix = new SlotixBooking({
baseUrl: 'https://API-SLOTIX/api/v1', // prefisso fornito dal tuo ambiente
page: 'dott-rossi'
});
const { workspace, services, professionals } = await slotix.catalog();
// Mostra il catalogo ricevuto; non mantenere una copia statica di prezzi e durate.
const slots = await slotix.slots({ service_id: services[0].id, target_date: '2026-12-01' });
const chosen = slots[0]; // il paziente sceglie una disponibilità effettiva
const receipt = await slotix.book({
service_id: services[0].id,
professional_id: chosen.professional_id, start: chosen.start,
client_name: 'Nome Cognome', contact: 'paziente@example.com',
privacy_accepted: true, privacy_version: workspace.privacy_version,
marketing_consent: false, language: 'it', source: 'direct'
});
// Consegna il link riservato al paziente. Usa il dominio frontend Slotix:
// https://APP-SLOTIX/visit/manage# + receipt.manage_token
// Oppure conserva il token in memoria e gestisci lo stato sul tuo sito:
await slotix.receipt(receipt.manage_token);
// await slotix.cancel(receipt.manage_token); // solo su richiesta del paziente
L’esempio richiede una scelta reale del paziente e la presa visione dell’informativa prima dell’invio. Il consenso promozionale è separato e facoltativo. Non raccogliere diagnosi o documenti con queste API. Le descrizioni ricevute vanno renderizzate come testo, per esempio con textContent.
Tutti i percorsi sono relativi al prefisso API. {page} può essere lo slug attuale, un suo alias precedente o il token originale. Scarica il contratto OpenAPI per gli schemi completi.
| Metodo e percorso | Uso |
|---|---|
| GET /public/activities/{page} | Informativa, catalogo attivo e professionisti |
| GET /public/activities/{page}/slots?service_id=…&target_date=YYYY-MM-DD | Orari delle visite. Filtro professional_id facoltativo. |
| GET /public/activities/{page}/courses?service_id=… | Lezioni, disponibilità e prezzo per nuove iscrizioni |
| POST /public/activities/{page}/book | Prenota una visita da un orario disponibile |
| POST /public/activities/{page}/courses/{id}/enroll | Iscrivi a una lezione; join_waitlist: true abilita l’attesa se piena |
| GET /public/activities/manage/booking | Stato della singola prenotazione |
| POST /public/activities/manage/cancel | Annullamento entro le regole dello studio |
| POST /public/activities/manage/accept | Accetta il posto offerto dalla lista |
| PUT /public/activities/manage/consent | {"marketing_consent": false} per revocare il consenso |
Le chiamate /manage/* richiedono X-Booking-Token, ricevuto solo alla creazione. Non metterlo in query string, log, analytics o codice pubblico. Chi possiede il token può gestire quella prenotazione. Le API rispondono con Cache-Control: no-store. Le chiamate del browser usano credentials: 'omit'.
Usa ISO 8601 con fuso per gli istanti; le date di ricerca sono nel fuso dello studio. Il server ricontrolla sempre la disponibilità e può rispondere 409 se un altro paziente prenota prima: aggiorna gli orari e chiedi una nuova scelta. 422 indica dati da correggere; 403 un’operazione non consentita; 404 una pagina non disponibile; 429 troppe richieste. Non ripetere automaticamente un invio dal risultato incerto.
Le lezioni mantengono l’orario già programmato anche se cambi la durata nel catalogo. Le nuove prenotazioni usano prezzo e nome correnti, quelle confermate conservano la propria copia. I pacchetti sono applicati dalla segreteria: il sito pubblico non può spendere ingressi tramite un ID cliente.
Apri la pagina di esempio. Per provarla su un dominio diverso, copia i due file di esempio e il client JavaScript sul tuo sito e autorizzane l’origine. Nessun invio avviene prima della conferma esplicita.