Jesdi se conecta con cualquier plataforma que gestione reservas.

Conceptos básicos

Todas las llamadas van a esta dirección, con tu clave en la cabecera. Los datos son JSON en UTF-8. Las fechas son AAAA-MM-DD y las horas HH:MM, en la hora local del restaurante (Europe/Amsterdam).

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

Restaurantes

Los restaurantes que han activado la conexión con tu plataforma. Usa el campo id en todas las demás llamadas. Si bookable es false, el restaurante está en pausa o ha cerrado las reservas en línea.

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

Horas libres

Las mismas reglas que el widget del propio restaurante: horario, capacidad, llegadas por franja, antelación mínima, vacaciones, mesas libres y el grupo más grande que puede reservar en línea. Solo recibes horas que se confirman al instante.

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

O por día en un periodo de hasta 62 días, por ejemplo para un calendario:

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

Si el restaurante ofrece elegir entre interior y terraza (seating_choice), añade &seating=terrace.

Crear una reserva

{ "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 (obligatorio) es tu número de reserva. Si envías el mismo external_id otra vez, recibes la reserva existente. Reintentar tras un tiempo de espera es, por tanto, seguro.
• email y phone son opcionales. Jesdi no envía su propia confirmación a los clientes de los socios; eso lo haces tú.
• Respuesta: 201 con la reserva, o 409 slot_unavailable si la hora acaba de llenarse.

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

Cambiar y cancelar

{ "date": "2026-10-16", "time": "20:00", "party": 4 }     // cambiar de hora
{ "status": "cancelled" }                                 // cancelar

Una reserva en el pasado, o cuyos clientes ya han llegado, ya no se puede cambiar (409).

Todas las reservas de tu plataforma que han cambiado desde ese momento. Útil si prefieres consultar en lugar de recibir webhooks.

Estado

status	Significado
confirmed	Confirmada
pending	El restaurante aún tiene que aprobarla
seated	Los clientes ya han llegado
cancelled	Cancelada
declined	Rechazada por el restaurante
no_show	No se presentó

Webhooks

Si el restaurante cancela o cambia una reserva, o la marca como llegada o no presentada, enviamos un POST a tu dirección de webhook en menos de un minuto. Si falla, lo reintentamos cada minuto hasta que respondas con un estado 2xx.

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

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

Códigos de error

HTTP	error	Significado
400	date_time_party_required, name_required, invalid_email	Falta un campo obligatorio o no es válido
401	unauthorized	La clave falta o no es válida
404	restaurant_not_connected, not_found	El restaurante no ha activado la conexión, o la reserva no existe
409	slot_unavailable, not_changeable	La hora está completa, o la reserva ya no se puede cambiar