Un’API REST per collegare la prenotazione a un sito su misura.
Fasce orarie, disponibilità e creazione della prenotazione in REST. L’interfaccia resta nelle Sue mani.Se il widget non basta, l’API pubblica di Couverty espone le fasce orarie, le disponibilità, la carta e la creazione della prenotazione. Lei disegna l’interfaccia che vuole, nel framework che vuole. Couverty gestisce l’agenda, le regole di capacità, le email e la protezione dai no-show.
Perché adottarlo
La Sua interfaccia, il nostro motore
Lei costruisce il modulo, il selettore di data e l’esperienza mobile che il progetto richiede. Dietro, Couverty applica orari, chiusure, capacità per sala e regole di servizio: la logica di business che nessuno ha voglia di riscrivere.
Le fasce orarie davvero disponibili
Gli endpoint di disponibilità e di fasce orarie restituiscono ciò che è prenotabile in quel preciso momento, chiusure e capacità incluse. Non mostrerà mai un orario che il ristorante non può onorare.
Autenticazione tramite chiave, per esercizio
Gli endpoint di dati si autenticano con un header X-API-Key o un Bearer token, con una chiave propria per ogni esercizio. La creazione della prenotazione resta pubblica (è ciò che utilizza il widget) ed è protetta da un limite di frequenza.
Non solo la prenotazione
La carta dei piatti, le bevande, il menu del giorno, le sale e i parametri del ristorante sono esposti dalla stessa API. Un sito su misura può mostrare una carta sempre aggiornata senza che nessuno la debba reinserire.
Come integrarlo
Generi una chiave API
Dalle impostazioni dell’account Couverty del ristorante, generi una chiave API. Si invia in un header X-API-Key, oppure come Bearer token se il Suo client HTTP lo preferisce.
curl -H "X-API-Key: qr_sua_chiave_api" \ https://api.couverty.ch/api/public/v1/restaurant
Legga le fasce orarie, poi crei la prenotazione
Interroghi le fasce orarie disponibili per la data scelta, le mostri come preferisce, poi invii la prenotazione. Il ristorante la vede arrivare nella sua agenda Couverty e le email di conferma partono automaticamente.
// 1. Le fasce orarie prenotabili per una data
const creneaux = await fetch(
`https://api.couverty.ch/api/public/${slug}/creneaux?date=2026-09-12&service=soir`
).then((r) => r.json());
// 2. La prenotazione
await fetch(`https://api.couverty.ch/api/public/${slug}/reservations`, {
method: 'POST',
headers: { 'Content-Type': 'application/json' },
body: JSON.stringify({
prenom: 'Jean',
nom: 'Dupont',
email: 'jean@example.com',
telephone: '+41 79 123 45 67',
dateReservation: '2026-09-12',
service: 'soir',
heureReservation: '19:30',
nombrePersonnes: 4,
}),
});Oppure lasci fare al Suo assistente di programmazione
Se sviluppa con Claude, Cursor o un altro assistente, gli incolli questo contesto: avrà l’URL di base, l’autenticazione e il contratto degli endpoint di cui ha bisogno per scrivere l’integrazione.
Integra la prenotazione Couverty su questo sito.
Base: https://api.couverty.ch
Documentazione: https://couverty.ch/docs/api
Auth (endpoint di dati): header "X-API-Key: qr_..."
Endpoint utili, dove {slug} è l'identificativo del ristorante:
GET /api/public/{slug}/config -> orari, servizi, impostazioni pubbliche
GET /api/public/{slug}/creneaux -> ?date=YYYY-MM-DD&service=midi|soir
GET /api/public/{slug}/availability -> disponibilità per data
GET /api/public/{slug}/menu -> carta dei piatti
POST /api/public/{slug}/reservations -> crea la prenotazione (pubblico, rate-limited)
Corpo del POST /reservations:
prenom, nom, email, telephone, dateReservation (YYYY-MM-DD),
service ("midi" | "soir"), heureReservation ("HH:mm"),
nombrePersonnes (number), commentaires (facoltativo)
Vincoli:
- mostra solo le fasce orarie restituite da /creneaux, non ricalcolarle;
- gestisci l'errore di una fascia oraria diventata completa tra la visualizzazione e l'invio;
- non inserire mai la chiave API nel codice client.Un sito Next.js su misura in cui la prenotazione fa parte del design
Il cliente vuole un percorso in tre passaggi, la sua tipografia, le sue animazioni. Non un iframe piazzato in mezzo alla pagina. Lei richiama le fasce orarie da un Server Component, rende il Suo selettore e invia la prenotazione da una Server Action. Per il ristorante non cambia nulla: la prenotazione arriva nella stessa agenda di quelle del widget, con le stesse email e le stesse regole anti no-show. Lei ha scritto solo l’interfaccia.
FAQDomande frequenti
Le domande più frequenti di integratori e sviluppatori.
No. L’endpoint di creazione è pubblico e limitato in frequenza. Sono gli endpoint di dati a richiedere una chiave.La creazione della prenotazione è l’endpoint utilizzato dal widget pubblico: è accessibile senza chiave e protetto da un limite di frequenza per IP. Gli endpoint che espongono i dati del ristorante (scheda, carta, impostazioni) si autenticano invece con una chiave API. Conseguenza pratica: non inserisca mai una chiave API in codice eseguito nel browser.
Le date di calendario sono nel formato YYYY-MM-DD, e l’ora nel formato HH:mm, separatamente.Il campo dateReservation si aspetta una data di calendario nel formato YYYY-MM-DD, senza ora né fuso orario. L’ora passa in un campo distinto, heureReservation, nel formato HH:mm. Questa separazione evita gli scarti di un giorno causati dalle conversioni di fuso orario. È una trappola classica in Svizzera, che è a UTC+1 o UTC+2 a seconda della stagione.
Sì: la scheda del ristorante, la carta dei piatti, le bevande, il menu del giorno, le sale e le chiusure.L’API copre l’essenziale dei dati pubblici di un esercizio. Può costruire una pagina carta che si aggiorna non appena il ristoratore modifica un piatto in Couverty, senza alcun inserimento lato sito. È esattamente ciò che fa il plugin WordPress ufficiale, che utilizza la stessa API.
Fa fede la documentazione API: consulti /docs/api per lo stato esatto delle notifiche in uscita.L’API è documentata su /docs/api, che resta la fonte di riferimento sugli endpoint e sulle notifiche disponibili. Se il Suo progetto ha bisogno di una notifica in uscita che la documentazione non copre, ci scriva: il contatto è diretto con il team che sviluppa l’API.
Gli endpoint di dati sono versionati nell’URL (/api/public/v1/). La versione dell’API è indipendente da quella dell’applicazione.Gli endpoint di dati pubblicano la loro versione nell’URL, sotto /api/public/v1/. Questa versione evolve con il proprio ritmo: una nuova versione dell’applicazione Couverty non rompe un’integrazione esistente. Gli endpoint per esercizio (/api/public/{slug}/...) sono quelli utilizzati dal widget e dal plugin ufficiale, e rispondono alla stessa esigenza di stabilità.
Una domanda? Ci contatti
Lei costruisce l’interfaccia, noi pensiamo al resto.
Documentazione completa, chiavi API per esercizio e contatto diretto con il team tecnico. Il programma partner remunera i ristoranti che porta.
Una domanda? contact@couverty.ch