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.
Nein. Der Endpoint zur Erstellung ist öffentlich und durch ein Rate Limit begrenzt. Die Daten-Endpoints verlangen einen Schlüssel.Die Erstellung einer Reservation ist der Endpoint, den das öffentliche Widget nutzt: Er ist ohne Schlüssel erreichbar und durch ein Rate Limit pro IP geschützt. Die Endpoints, die Daten des Restaurants bereitstellen (Profil, Karte, Einstellungen), authentifizieren sich hingegen mit einem API-Schlüssel. Praktische Folge: Legen Sie nie einen API-Schlüssel in Code ab, der im Browser ausgeführt wird.
Kalenderdaten im Format YYYY-MM-DD, die Uhrzeit separat im Format HH:mm.Das Feld dateReservation erwartet ein Kalenderdatum im Format YYYY-MM-DD, ohne Uhrzeit und ohne Zeitzone. Die Uhrzeit steht in einem eigenen Feld, heureReservation, im Format HH:mm. Diese Trennung verhindert Verschiebungen um einen Tag durch Zeitzonenumrechnungen. Eine klassische Falle in der Schweiz, die je nach Jahreszeit bei UTC+1 oder UTC+2 liegt.
Ja: Profil des Restaurants, Speisekarte, Getränke, Tagesmenu, Räume und Schliessungen.Die API deckt das Wesentliche der öffentlichen Daten eines Betriebs ab. Sie können eine Kartenseite bauen, die sich aktualisiert, sobald der Gastronom ein Gericht in Couverty ändert, ohne jede Eingabe auf der Website. Genau das macht das offizielle WordPress-Plugin, das dieselbe API nutzt.
Massgebend ist die API-Dokumentation: Den genauen Stand der ausgehenden Benachrichtigungen finden Sie unter /docs/api.Die API ist unter /docs/api dokumentiert, die massgebende Quelle zu den verfügbaren Endpoints und Benachrichtigungen. Wenn Ihr Projekt eine ausgehende Benachrichtigung braucht, die die Dokumentation nicht abdeckt, schreiben Sie uns: Sie haben direkten Kontakt zum Team, das die API entwickelt.
Die Daten-Endpoints sind in der URL versioniert (/api/public/v1/). Die API-Version ist unabhängig von jener der Anwendung.Die Daten-Endpoints tragen ihre Version in der URL, unter /api/public/v1/. Diese Version entwickelt sich in ihrem eigenen Rhythmus: Eine neue Version der Couverty-Anwendung bricht keine bestehende Integration. Die Endpoints pro Betrieb (/api/public/{slug}/...) sind jene, die das Widget und das offizielle Plugin nutzen, und unterliegen derselben Stabilitätsanforderung.
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