Integrationen · Partner API

Jesdi verbindet sich mit jeder Plattform, die Reservierungen macht.

Sind Sie eine Reservierungsplattform, Deal-Seite, ein Restaurantführer oder eine App? Mit der Jesdi Partner API sehen Sie in Echtzeit die freien Zeiten unserer Restaurants und tragen Reservierungen direkt in ihren Kalender ein. Keine Doppelbuchungen, kein Abtippen und kein Aufwand für das Restaurant.

Kostenlos, für Plattformen und Restaurants · Jede Anbindung innerhalb eines Tages gebaut · Testschlüssel mit einem Demo-Restaurant

Warum anbinden

Ein Kalender für das Restaurant, echte Verfügbarkeit für Sie.

Immer die echten freien Zeiten

Sie sehen genau, was das Restaurant online anbietet: Öffnungszeiten, Kapazität, freie Tische, Urlaub und volle Tage. Was Sie verkaufen, kann das Restaurant auch wirklich einlösen.

Direkt im Kalender

Ihre Reservierung steht sofort im Kalender des Restaurants, mit Ihrem Namen als Label. Ändert oder storniert das Restaurant etwas, erfahren Sie es innerhalb einer Minute.

Kostenlos und innerhalb eines Tages angebunden

Die Anbindung kostet nichts, weder für Sie noch für das Restaurant. Nutzen Sie unsere API, oder arbeiten Sie lieber mit Ihrer eigenen API? Dann bauen wir die Anbindung an Ihr System innerhalb eines Tages.

So funktioniert es

In vier Schritten angebunden.

Schlüssel anfragen

Schreiben Sie uns mit Ihrem Firmennamen und dem, was Sie anbinden möchten. Sie bekommen einen Testschlüssel. Haben Sie eine eigene API, bauen wir die Anbindung innerhalb eines Tages.

Testen

Probieren Sie freie Zeiten, Reservieren, Ändern und Stornieren mit unserem Demo-Restaurant aus.

Das Restaurant schaltet es ein

Das Restaurant wählt in seinem Jesdi-Backoffice Ihre Plattform. Erst dann sehen Sie seine Zeiten.

Live

Reservierungen über Ihre Plattform stehen direkt im Kalender. Auch für jedes weitere Restaurant.

Dokumentation

Jesdi Partner API v1

Alles, was Sie für die Anbindung brauchen. Die Beispiele sind auf Englisch, wie die API selbst.

Grundlagen

Alle Aufrufe gehen an diese Adresse, mit Ihrem Schlüssel im Header. Daten sind JSON in UTF-8. Datumsangaben sind JJJJ-MM-TT und Uhrzeiten HH:MM, in der Ortszeit des Restaurants (Europe/Amsterdam).

Base URL:  https://jesdi.nl/partner/v1
Header:    Authorization: Bearer <your api key>

Restaurants

Die Restaurants, die die Anbindung an Ihre Plattform eingeschaltet haben. Das Feld id verwenden Sie in allen anderen Aufrufen. Steht bookable auf false, ist das Restaurant pausiert oder hat Online-Reservierungen geschlossen.

GET/restaurants
{ "restaurants": [ {
    "id": "in-den-vlaemschen-pot", "name": "In den Vlaemschen Pot",
    "address": "…", "phone": "…", "website": "…",
    "bookable": true, "max_party": 8, "seating_choice": false,
    "slot_minutes": 30, "duration_minutes": 120, "days_ahead": 120
} ] }

Freie Zeiten

Dieselben Regeln wie das eigene Widget des Restaurants: Öffnungszeiten, Kapazität, Ankünfte pro Zeitfenster, minimale Vorlaufzeit, Urlaub, freie Tische und die größte Gruppe, die online reservieren darf. Sie bekommen nur Zeiten, die sofort bestätigt werden.

GET/restaurants/{id}/availability?date=2026-10-15&party=2
{ "date": "2026-10-15", "party": 2, "times": ["17:30", "18:00", "20:30"] }

Oder pro Tag über einen Zeitraum von maximal 62 Tagen, zum Beispiel für einen Kalender:

GET/restaurants/{id}/availability?from=2026-10-15&to=2026-11-15&party=2
{ "party": 2, "days": { "2026-10-15": "open", "2026-10-16": "full", "2026-10-17": "closed" } }

Bietet das Restaurant eine Wahl zwischen innen und Terrasse (seating_choice), fügen Sie &seating=terrace hinzu.

Reservierung anlegen

POST/restaurants/{id}/reservations
{ "external_id": "DS-1001", "date": "2026-10-15", "time": "19:00", "party": 2,
  "name": "Jan de Vries", "email": "jan@example.com", "phone": "+31612345678",
  "remarks": "Restaurant Week menu, 1x gluten free", "seating": "indoor", "lang": "nl" }
  • external_id (Pflicht) ist Ihre Reservierungsnummer. Senden Sie dieselbe external_id noch einmal, bekommen Sie die bestehende Reservierung zurück. Ein erneuter Versuch nach einem Timeout ist also sicher.
  • email und phone sind optional. Jesdi sendet Gästen von Partnern keine eigene Bestätigung; das machen Sie.
  • Antwort: 201 mit der Reservierung oder 409 slot_unavailable, wenn die Zeit gerade ausgebucht ist.
{ "reservation": {
    "id": 35, "external_id": "DS-1001", "restaurant": "in-den-vlaemschen-pot",
    "date": "2026-10-15", "time": "19:00", "duration_minutes": 120, "party": 2,
    "seating": null, "status": "confirmed", "name": "Jan de Vries",
    "remarks": "…", "updated_at": "2026-10-07 16:10:00"
} }

Ändern und stornieren

GET/reservations/{external_id}
PATCH/reservations/{external_id}
{ "date": "2026-10-16", "time": "20:00", "party": 4 }     // verschieben
{ "status": "cancelled" }                                 // stornieren

Eine Reservierung in der Vergangenheit oder deren Gäste schon da sind, kann nicht mehr geändert werden (409).

GET/reservations?updated_since=2026-10-07 12:00:00

Alle Reservierungen Ihrer Plattform, die sich seit diesem Zeitpunkt geändert haben. Praktisch, wenn Sie lieber abrufen als Webhooks empfangen.

Status

statusBedeutung
confirmedBestätigt
pendingDas Restaurant muss noch genehmigen
seatedDie Gäste sind da
cancelledStorniert
declinedVom Restaurant abgelehnt
no_showNicht erschienen

Webhooks

Storniert oder verschiebt das Restaurant eine Reservierung oder setzt sie auf da oder nicht erschienen, senden wir innerhalb einer Minute einen POST an Ihre Webhook-Adresse. Klappt das nicht, versuchen wir es jede Minute erneut, bis Sie mit einem 2xx-Status antworten.

POST https://your-platform.example/jesdi-webhook
X-Jesdi-Signature: sha256=<hmac of the body with your webhook secret>

{ "event": "reservation.updated", "reservation": { … } }

Fehlercodes

HTTPerrorBedeutung
400date_time_party_required, name_required, invalid_emailEin Pflichtfeld fehlt oder ist nicht korrekt
401unauthorizedSchlüssel fehlt oder ist ungültig
404restaurant_not_connected, not_foundDas Restaurant hat die Anbindung nicht eingeschaltet oder die Reservierung existiert nicht
409slot_unavailable, not_changeableDie Zeit ist ausgebucht oder die Reservierung kann nicht mehr geändert werden

Bereit zur Anbindung?

Die Anbindung ist kostenlos. Schreiben Sie uns Ihren Firmennamen und was Sie anbinden möchten: Sie bekommen einen Testschlüssel und ein Demo-Restaurant, oder wir bauen die Anbindung an Ihre eigene API innerhalb eines Tages.

API-Schlüssel anfragen