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.
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