# Koppelingen, agenda en API

> 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.

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](https://app.dineflow.nl/images/docs/koppelingen-scherm.webp "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](https://app.dineflow.nl/images/docs/koppelingen-websitebouwer.webp "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 reserveerlink delen](https://dineflow.nl/handleiding/reserveerpagina-delen)
- [De reserveerpagina en reserveerknop instellen](https://dineflow.nl/handleiding/reserveerpagina-instellen)
- [Toegang en rollen](https://dineflow.nl/handleiding/team-en-rollen)
