Jesdi si collega con qualsiasi piattaforma che riceve prenotazioni.

Basi

Tutte le chiamate vanno a questo indirizzo, con la tua chiave nell'header. I dati sono JSON in UTF-8. Le date sono YYYY-MM-DD e gli orari HH:MM, nell'ora locale del ristorante (Europe/Amsterdam).

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

Ristoranti

I ristoranti che hanno attivato il collegamento con la tua piattaforma. Usa il campo id in tutte le altre chiamate. Se bookable è false, il ristorante è in pausa o ha chiuso le prenotazioni online.

{ "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
} ] }

Orari liberi

Le stesse regole del widget del ristorante: orari, capacità, arrivi per fascia oraria, preavviso minimo, ferie, tavoli liberi e il gruppo più grande prenotabile online. Ricevi solo orari confermati subito.

{ "date": "2026-10-15", "party": 2, "times": ["17:30", "18:00", "20:30"] }

Oppure per giorno su un periodo fino a 62 giorni, per esempio per un calendario:

{ "party": 2, "days": { "2026-10-15": "open", "2026-10-16": "full", "2026-10-17": "closed" } }

Se il ristorante offre la scelta tra interno e terrazza (seating_choice), aggiungi &seating=terrace.

Crea una prenotazione

{ "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 (obbligatorio) è il tuo numero di prenotazione. Se invii di nuovo lo stesso external_id, ricevi la prenotazione esistente. Riprovare dopo un timeout è quindi sicuro.
• email e phone sono facoltativi. Jesdi non invia una propria conferma agli ospiti dei partner; lo fai tu.
• Risposta: 201 con la prenotazione, oppure 409 slot_unavailable se l'orario si è appena riempito.

{ "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"
} }

Modificare e cancellare

{ "date": "2026-10-16", "time": "20:00", "party": 4 }     // spostare
{ "status": "cancelled" }                                 // cancellare

Una prenotazione nel passato, o in cui gli ospiti sono già arrivati, non si può più modificare (409).

Tutte le prenotazioni della tua piattaforma modificate da quel momento. Utile se preferisci il polling ai webhook.

Stato

status	Significato
confirmed	Confermata
pending	Il ristorante deve ancora approvare
seated	Gli ospiti sono arrivati
cancelled	Annullata
declined	Rifiutata dal ristorante
no_show	Non presentato

Webhooks

Se il ristorante cancella o sposta una prenotazione, o la segna come arrivata o no-show, inviamo entro un minuto un POST al tuo indirizzo webhook. Se non riesce, riproviamo ogni minuto finché non rispondi con uno stato 2xx.

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

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

Codici di errore

HTTP	error	Significato
400	date_time_party_required, name_required, invalid_email	Un campo obbligatorio manca o non è valido
401	unauthorized	La chiave manca o non è valida
404	restaurant_not_connected, not_found	Il ristorante non ha attivato il collegamento, oppure la prenotazione non esiste
409	slot_unavailable, not_changeable	L'orario è pieno, oppure la prenotazione non si può più modificare