Eine REST-API für die Reservation auf einer massgeschneiderten Website.
Zeitfenster, Verfügbarkeiten und Reservationen per REST. Die Oberfläche bleibt in Ihrer Hand.Wenn das Widget nicht reicht, stellt die öffentliche Couverty-API Zeitfenster, Verfügbarkeiten, Karte und die Erstellung von Reservationen bereit. Sie gestalten die Oberfläche, die Sie wollen, im Framework, das Sie wollen. Couverty verwaltet Agenda, Kapazitätsregeln, E-Mails und den No-Show-Schutz.
Warum es sich lohnt
Ihre Oberfläche, unser Motor
Sie bauen das Formular, die Datumsauswahl und das mobile Erlebnis, die das Projekt verlangt. Couverty wendet im Hintergrund Öffnungszeiten, Schliessungen, Kapazitäten pro Raum und Service-Regeln an: die Geschäftslogik, die niemand neu schreiben möchte.
Nur tatsächlich verfügbare Zeitfenster
Die Endpoints für Verfügbarkeiten und Zeitfenster liefern, was im Moment reservierbar ist, Schliessungen und Kapazität inbegriffen. Sie zeigen nie eine Uhrzeit an, die das Restaurant nicht einhalten kann.
Authentifizierung per Schlüssel, pro Betrieb
Die Daten-Endpoints authentifizieren sich über einen X-API-Key-Header oder einen Bearer-Token, mit einem eigenen Schlüssel für jeden Betrieb. Die Erstellung von Reservationen bleibt öffentlich (das nutzt das Widget) und ist durch ein Rate Limit geschützt.
Nicht nur die Reservation
Speisekarte, Getränke, Tagesmenu, Räume und Einstellungen des Restaurants werden über dieselbe API bereitgestellt. Eine massgeschneiderte Website kann eine stets aktuelle Karte anzeigen, ohne dass jemand sie neu erfasst.
So binden Sie es ein
API-Schlüssel generieren
Generieren Sie in den Einstellungen des Couverty-Kontos des Restaurants einen API-Schlüssel. Er wird in einem X-API-Key-Header gesendet, oder als Bearer-Token, falls Ihr HTTP-Client das bevorzugt.
curl -H "X-API-Key: qr_ihr_api_schluessel" \ https://api.couverty.ch/api/public/v1/restaurant
Zeitfenster abfragen, dann die Reservation erstellen
Fragen Sie die verfügbaren Zeitfenster für das gewählte Datum ab, zeigen Sie sie so an, wie Sie möchten, und senden Sie dann die Reservation. Das Restaurant sieht sie in seiner Couverty-Agenda eintreffen, und die Bestätigungs-E-Mails gehen automatisch hinaus.
// 1. Die reservierbaren Zeitfenster für ein Datum
const creneaux = await fetch(
`https://api.couverty.ch/api/public/${slug}/creneaux?date=2026-09-12&service=soir`
).then((r) => r.json());
// 2. Die Reservation
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,
}),
});Oder überlassen Sie es Ihrem Coding-Assistenten
Wenn Sie mit Claude, Cursor oder einem anderen Assistenten entwickeln, geben Sie ihm diesen Kontext: Er erhält die Basis-URL, die Authentifizierung und den Vertrag der Endpoints, die er für die Integration braucht.
Integriere die Couverty-Reservation auf dieser Website.
Basis: https://api.couverty.ch
Doku: https://couverty.ch/docs/api
Auth (Daten-Endpoints): Header "X-API-Key: qr_..."
Nützliche Endpoints, wobei {slug} die Kennung des Restaurants ist:
GET /api/public/{slug}/config -> Öffnungszeiten, Services, öffentliche Einstellungen
GET /api/public/{slug}/creneaux -> ?date=YYYY-MM-DD&service=midi|soir
GET /api/public/{slug}/availability -> Verfügbarkeit pro Datum
GET /api/public/{slug}/menu -> Speisekarte
POST /api/public/{slug}/reservations -> erstellt die Reservation (öffentlich, rate-limitiert)
Body von POST /reservations:
prenom, nom, email, telephone, dateReservation (YYYY-MM-DD),
service ("midi" | "soir"), heureReservation ("HH:mm"),
nombrePersonnes (number), commentaires (optional)
Vorgaben:
- zeige nur die von /creneaux gelieferten Zeitfenster an, berechne sie nicht neu;
- behandle den Fehler, wenn ein Zeitfenster zwischen Anzeige und Absenden ausgebucht ist;
- lege den API-Schlüssel nie in Client-Code ab.Eine massgeschneiderte Next.js-Website, bei der die Reservation Teil des Designs ist
Der Kunde will einen Ablauf in drei Schritten, seine Typografie, seine Animationen. Kein iframe mitten auf der Seite. Sie rufen die Zeitfenster aus einer Server Component ab, rendern Ihre eigene Auswahl und senden die Reservation aus einer Server Action. Für das Restaurant ändert sich nichts: Die Reservation landet in derselben Agenda wie jene aus dem Widget, mit denselben E-Mails und denselben No-Show-Regeln. Sie haben nur die Oberfläche geschrieben.
FAQHäufige Fragen
Die häufigsten Fragen von Integratoren und Entwicklern.
Eine Frage? Kontaktieren Sie uns
Sie bauen die Oberfläche, wir kümmern uns um den Rest.
Vollständige Dokumentation, API-Schlüssel pro Betrieb und direkter Kontakt zum technischen Team. Das Partnerprogramm vergütet die Restaurants, die Sie bringen.
Eine Frage? contact@couverty.ch