Entwickler

Eine klare REST-API für Verfügbarkeit und Buchungen.

Lesen Sie Echtzeit-Verfügbarkeit aus und erstellen Sie Reservierungen für Ihre eigenen Restaurants programmatisch. Authentifizieren Sie sich mit einem einzigen Bearer-Token, erhalten Sie JSON zurück und binden Sie Tablevent in den Rest Ihres Stacks ein.

API-Schlüssel erstellen

Authentifizierung

Jede Anfrage wird mit einem API-Schlüssel authentifiziert, den Sie selbst erstellen. Schlüssel sind auf Ihre Organisation und nur auf die Restaurants beschränkt, die Ihnen gehören. Senden Sie Ihren Schlüssel als Bearer-Token im Authorization-Header — Schlüssel werden einmalig angezeigt und nur als Hash gespeichert, bewahren Sie Ihren also sicher auf.

1Melden Sie sich an und öffnen Sie API keys in Ihrem Verwaltungs-Dashboard.
2Erstellen Sie einen Schlüssel — kopieren Sie das einmalig angezeigte tvk_…-Geheimnis.
3Senden Sie es bei jeder Anfrage als Bearer-Token.

API-Schlüssel erstellen

Authorization-Header

Authorization: Bearer tvk_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Basis-URL

Alle Endpunkte werden per HTTPS von einem einzigen Host bereitgestellt. Antworten sind JSON; Fehler liefern einen JSON-Body mit einem error-Feld und einem passenden HTTP-Status (401 nicht autorisiert, 404 nicht gefunden, 409 Konflikt, 429 Ratenbegrenzung).

https://tablevent.com

Endpunkte

Die öffentliche API ist bewusst klein und stabil. Hier ist alles, was heute verfügbar ist — weitere Endpunkte folgen.

GET/api/v1/availability

Gibt buchbare Zeitfenster für eines Ihrer Restaurants an einem bestimmten Datum und für eine bestimmte Gruppengröße zurück. Query-Parameter: slug, date (JJJJ-MM-TT) und party.

Beispielanfrage

curl "https://tablevent.com/api/v1/availability?slug=your-restaurant&date=2026-07-01&party=2" \
  -H "Authorization: Bearer tvk_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

GET/api/v1/bookings

Listet die jüngsten Buchungen Ihrer Organisation (letzte 30 Tage) über alle Ihre Restaurants auf, neueste zuerst.

Beispielanfrage

curl "https://tablevent.com/api/v1/bookings" \
  -H "Authorization: Bearer tvk_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

POST/api/v1/bookings

Erstellt eine bestätigte Buchung. Prüft die Echtzeit-Verfügbarkeit unter einem Lock erneut, sodass Sie den letzten Tisch nie überbuchen können. Gibt die ID der neuen Buchung zurück.

Beispielanfrage

curl -X POST "https://tablevent.com/api/v1/bookings" \
  -H "Authorization: Bearer tvk_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "slug": "your-restaurant",
    "startsAt": "2026-07-01T19:00:00.000Z",
    "partySize": 2,
    "name": "Ada Lovelace",
    "email": "[email protected]"
  }'

Ratenbegrenzungen

Limits gelten pro Organisation über einen Token-Bucket. Das Überschreiten eines Limits liefert HTTP 429 — warten Sie und versuchen Sie es erneut.

Lesezugriffe (Verfügbarkeit, Buchungen auflisten): Burst von 120, Nachfüllung 2 Anfragen/Sekunde
Schreibzugriffe (Buchung erstellen): Burst von 30, Nachfüllung 1 Anfrage alle 2 Sekunden

Bereit zu bauen?

Erstellen Sie einen Schlüssel in Ihrem Dashboard und machen Sie Ihren ersten Aufruf in wenigen Minuten. Brauchen Sie einen Endpunkt, den wir noch nicht listen? Sagen Sie uns, was Sie bauen.

API-Schlüssel erstellen Sprechen Sie mit uns