DineFlow Handleiding
Alle onderwerpen

Koppelingen, agenda en API

Bijgewerkt op

In het kort

Zet je reserveringen in Google Agenda of op je iPhone, en laat je website of een ander programma met Dineflow werken via de API en webhooks.

Video: Koppelingen en je agenda · 0:59
Op deze pagina

Onder Instellingen → Koppelingen laat je je reserveringen buiten Dineflow zien of gebruiken. Het meest gebruikt: een agendalink, zodat je elke reservering in Google Agenda of de agenda op je iPhone ziet, naast je eigen afspraken. Voor je websitebouwer staan hier ook de API-sleutels en webhooks, waarmee een ander programma met je reserveringen kan werken.

Waar vind je het: Instellingen → Koppelingen (of op Alle instellingen de kaart Koppelingen). Alleen de eigenaar ziet dit scherm, omdat het om de gegevens van je gasten gaat.

Het scherm Koppelingen met Je reserveringen in je agenda, Wat er gekoppeld is en Voor je websitebouwer
Koppelingen: je agenda bovenaan, de rest voor je websitebouwer.

Je reserveringen in je agenda

Met de agendalink zie je de reserveringen van de komende 60 dagen in je eigen agenda. Je agenda haalt ze zelf op en werkt zichzelf bij. Hoe vaak, bepaalt je agenda-app: meestal binnen een kwartier tot een uur.

  1. Druk op Agendalink maken.
  2. Druk naast Je agendalink op Kopiëren.
  3. Google Agenda (op de computer): klik bij Andere agenda's op het plusje, dan Via URL, en plak de link.
  4. iPhone: Instellingen → Agenda → Accounts → Account toevoegen → Andere → Voeg agenda-abonnement toe, en plak de link.

In de agenda staan de naam, het aantal personen en de tafel. Telefoonnummers, e-mailadressen en allergieën staan er bewust niet in: een agendalink wordt gedeeld.

Heb je de link met de verkeerde persoon gedeeld? Druk op Nieuwe link maken. De oude link werkt dan meteen niet meer. Met Link uitzetten stop je hem helemaal.

Wat er gekoppeld is

Onder Wat er gekoppeld is zie je elk programma of elke website die met je reserveringen werkt, en wat het mag. Staat er Nog niets gekoppeld, dan is er niets.

  • Een API-sleutel zie je met wat hij mag en wanneer hij voor het laatst is gebruikt. Met Intrekken werkt hij meteen niet meer. Dat kun je niet terugdraaien; wil je het later weer, maak dan een nieuwe sleutel.
  • Een webhook zie je als Berichten naar …, met Werkt, Laatste niet aangekomen of Uitgezet. Je hebt de knoppen Test versturen, Verwijderen en, als hij uit staat, Weer aanzetten. Onder Details en laatste berichten zie je wat er is verstuurd en wat de server antwoordde.

Werkt je websitebouwer niet meer voor je? Trek zijn sleutel dan in.

Voor je websitebouwer

Wil je dat je website, je boekhouding of een eigen app met je reserveringen werkt? Klap dan Voor je websitebouwer open en geef de rest van dit artikel aan wie dat voor je bouwt.

Voor je websitebouwer opengeklapt, met API-sleutel maken en Webhook toevoegen
Een API-sleutel maken of een webhook toevoegen.

Voor je websitebouwer: de API

Met een API-sleutel kan een ander programma (je website, je boekhouding, een eigen app) vrije tafels opvragen en reserveringen lezen, maken en annuleren, volgens dezelfde regels als je reserveerpagina.

  1. Klap Voor je websitebouwer open.
  2. Vul bij Naam in wie of wat de sleutel gebruikt, zodat je hem later herkent.
  3. Vink bij Wat mag hij? aan wat nodig is:
    • Vrije tafels opvragen (availability:read) — zonder gastgegevens
    • Reserveringen bekijken (reservations:read) — met namen en contactgegevens
    • Reserveringen maken en annuleren (reservations:write)
  4. Druk op Sleutel maken.
  5. Kopieer de sleutel onder Je nieuwe sleutel en druk op Ik heb hem bewaard.

De sleutel zie je één keer. Dineflow bewaart alleen een vingerafdruk ervan, dus kwijt is kwijt: trek hem in en maak een nieuwe.

Alle adressen beginnen met https://app.dineflow.nl/api/public/v1. Je stuurt de sleutel mee als header:

Authorization: Bearer dfk_...

Antwoorden zijn JSON. Een fout ziet er zo uit, met een vaste code om op te controleren en een Engelse zin voor mensen:

{"error": {"code": "not_available", "message": "There is no table available at that time. (reason: no_table)"}}

Een ongeldig veld geeft status 422 met message en per veld errors. Per sleutel mag je 120 verzoeken per minuut doen; daarboven krijg je status 429.

Vrije tafels

curl "https://app.dineflow.nl/api/public/v1/availability?date=2026-12-24&party_size=4" \
  -H "Authorization: Bearer dfk_..."

Geeft elke begintijd van die dag, met available en, als hij niet kan, een reason (zoals slot_full, closed of too_soon). Het zijn dezelfde regels als op je reserveerpagina.

Reserveringen lezen

curl "https://app.dineflow.nl/api/public/v1/reservations?from=2026-12-01&to=2026-12-31&status=confirmed,pending" \
  -H "Authorization: Bearer dfk_..."

curl "https://app.dineflow.nl/api/public/v1/reservations/123" \
  -H "Authorization: Bearer dfk_..."

from en to gaan over de dag van de dienst (een tafel om half één 's nachts hoort bij de avond ervoor), maximaal 92 dagen per keer. De lijst komt in pagina's: page en per_page (tot 100). Elke reservering heeft onder meer id, reference, status, date, starts_at, party_size, name, email, phone, allergies en tables.

Een reservering maken

curl -X POST "https://app.dineflow.nl/api/public/v1/reservations" \
  -H "Authorization: Bearer dfk_..." \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: 6f1c2a" \
  -d '{"date": "2026-12-24", "time": "19:00", "party_size": 4,
       "name": "Sanne de Vries", "email": "sanne@example.com"}'

Verplicht zijn date, time, party_size, name en een email of phone. Optioneel: notes, occasion, allergies (een lijst, zoals ["noten"]) en send_confirmation (standaard true: de gast krijgt dezelfde bevestiging als via je reserveerpagina). Dineflow kiest zelf een tafel. Stuur je dezelfde Idempotency-Key nog eens, bijvoorbeeld na een time-out, dan krijg je de reservering van de eerste keer terug in plaats van een tweede.

Is er geen plek, dan krijg je status 409 met code not_available. In je overzicht staat zo'n reservering met de bron Koppeling.

Een reservering annuleren

curl -X POST "https://app.dineflow.nl/api/public/v1/reservations/123/cancel" \
  -H "Authorization: Bearer dfk_..." \
  -H "Content-Type: application/json" \
  -d '{"reason": "Gast belde af", "notify_guest": true}'

Alleen een reservering die nog moet komen (pending of confirmed) kan geannuleerd worden.

Voor je websitebouwer: webhooks

Een webhook is het omgekeerde: Dineflow stuurt zelf een bericht naar een adres van jou zodra er iets gebeurt. Je kiest uit reservation.created, reservation.updated (andere tijd of tafel, aangekomen, afgerond, no-show) en reservation.cancelled. Het adres moet met https:// beginnen en vanaf internet bereikbaar zijn.

Elk bericht is een POST met JSON:

{"id": "…", "event": "reservation.created", "created_at": "…",
 "venue": {"id": 1, "name": "…"},
 "data": {"change": "created", "reservation": { … }}}

De header Dineflow-Signature: t=1766600000,v1=… is een HMAC-SHA256 van t + . + de body, met het geheim van de webhook (dat zie je onder Geheim tonen). Controleer hem, en weiger een bericht dat ouder is dan een paar minuten. Dineflow-Delivery blijft gelijk bij een nieuwe poging, zodat je een herhaling kunt herkennen.

Antwoord met een 2xx-status. Anders proberen we het opnieuw, steeds iets later, een paar uur lang. Komen tien berichten achter elkaar niet aan, dan zetten we de webhook uit; je zet hem weer aan op het scherm Koppelingen. Daar staan ook de laatste 50 berichten met het antwoord van je server, en een knop Test versturen.

Veelgestelde vragen

Hoe zet ik mijn reserveringen in Google Agenda? Druk onder Instellingen → Koppelingen op Agendalink maken, kopieer de link en voeg hem in Google Agenda toe bij Andere agenda's → Via URL.

Kan de AI copilot een API-sleutel voor me maken? Nee. Een sleutel is een geheim, en dat hoort niet in een chat. De copilot kan wel vertellen wat er gekoppeld is.

Wat gebeurt er als mijn abonnement stopt? Dan werkt de API niet meer, net als je reserveerpagina.

Kost de API extra? Nee. Het zit in je abonnement, net als de rest.

Lees ook

Je restaurant instellen

Meer over dit onderwerp