La tua pagina, le prenotazioni Slotix

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.

  1. In Activities → Studio e prenotazioni → Integrazione con il tuo sito web, salva l’origine del sito (per esempio https://www.studio.it). Ogni variante, compresa www, va autorizzata esplicitamente.
  2. Apri le prenotazioni e configura il tuo indirizzo pubblico. Lo slug, per esempio dott-rossi, identifica la pagina; non è una credenziale.
  3. Copia il client JavaScript nel tuo sito e usa l’URL API del tuo ambiente. Non inserire credenziali staff nel browser.

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.

Esempio JavaScript

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.

Contratto HTTP

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 percorsoUso
GET /public/activities/{page}Informativa, catalogo attivo e professionisti
GET /public/activities/{page}/slots?service_id=…&target_date=YYYY-MM-DDOrari delle visite. Filtro professional_id facoltativo.
GET /public/activities/{page}/courses?service_id=…Lezioni, disponibilità e prezzo per nuove iscrizioni
POST /public/activities/{page}/bookPrenota una visita da un orario disponibile
POST /public/activities/{page}/courses/{id}/enrollIscrivi a una lezione; join_waitlist: true abilita l’attesa se piena
GET /public/activities/manage/bookingStato della singola prenotazione
POST /public/activities/manage/cancelAnnullamento entro le regole dello studio
POST /public/activities/manage/acceptAccetta 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.

Prova dal tuo sito

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.