Entwicklerdokumentation

REST-API-Schnellstart

Ihre erste Buchung mit drei HTTP-Aufrufen – Location lesen, freien Slot finden, reservieren – aus dem Terminal oder jeder Sprache, mit einem geheimen Schlüssel.

Sie buchen einen Tisch mit reinem HTTP: drei Aufrufe, ein geheimer Schlüssel und nichts zu installieren. Sie brauchen curl, einen geheimen API-Schlüssel und einen Location-Slug (demo-sportsbar genügt zum Lesen).

1. Geheimen Schlüssel anlegen

Öffnen Sie in der Konsole Location → API-Schlüssel und legen Sie einen Schlüssel vom Typ Geheim an; er wird nur einmal angezeigt. Halten Sie ihn in einer Umgebungsvariable, nicht in einer Datei, die Sie einchecken:

export BOOKDINEPLAY_KEY="<your secret key>"

Ein geheimer Schlüssel gehört in den Header X-BookDinePlay-Key (oder als Authorization: Bearer), nie in einen Query-String. Er ist für Server und Terminals: Eine Anfrage mit geheimem Schlüssel und einem Browser-Origin-Header wird abgelehnt. Code, der im Browser läuft, nimmt stattdessen einen veröffentlichbaren Schlüssel (JavaScript-Schnellstart).

2. Location lesen

Das beweist, dass der Schlüssel funktioniert, und liefert Zeitzone, Ressourcentypen und Buchungsdauern der Location:

curl

curl "https://api.bookdineplay.com/api/venues/your-venue" \
  -H "X-BookDinePlay-Key: $BOOKDINEPLAY_KEY"

JavaScript

const venue = await (await fetch('https://api.bookdineplay.com/api/venues/your-venue', {
  headers: { 'X-BookDinePlay-Key': process.env.BOOKDINEPLAY_KEY }
})).json();
console.log(venue.name, venue.timezone);

C#

var venue = await client.GetVenueAsync("your-venue", cancellationToken);
Console.WriteLine($"{venue?.Name} {venue?.Timezone}");

PHP

<?php
$response = wp_remote_get( 'https://api.bookdineplay.com/api/venues/your-venue', [ 'headers' => [ 'X-BookDinePlay-Key' => BOOKDINEPLAY_SECRET_KEY ] ] );
$venue = json_decode( wp_remote_retrieve_body( $response ), true );
echo $venue['name'] . ' ' . $venue['timezone'];

3. Freien Slot finden

Fragen Sie nach einem Datum (Ortszeit der Location, yyyy-MM-dd), einer Personenzahl und einem Ressourcentyp. Die Antwort listet die Slots mit start, end, resourceId und ob jeder available ist:

curl

DAY=$(date -d tomorrow +%F 2>/dev/null || date -v+1d +%F)
curl "https://api.bookdineplay.com/api/venues/your-venue/availability?date=$DAY&partySize=4&resourceType=RestaurantTable" \
  -H "X-BookDinePlay-Key: $BOOKDINEPLAY_KEY"

JavaScript

const day = new Date(Date.now() + 24 * 60 * 60 * 1000).toISOString().slice(0, 10);
const query = new URLSearchParams({ date: day, partySize: '4', resourceType: 'RestaurantTable' });
const availability = await (await fetch(`https://api.bookdineplay.com/api/venues/your-venue/availability?${query}`, {
  headers: { 'X-BookDinePlay-Key': process.env.BOOKDINEPLAY_KEY }
})).json();
const slot = availability.slots.find((s) => s.available);

C#

var availability = await client.GetAvailabilityAsync(
    "your-venue", DateOnly.FromDateTime(DateTime.Today).AddDays(1), partySize: 4,
    BookableResourceType.RestaurantTable, cancellationToken: cancellationToken);
var slot = availability?.Slots.FirstOrDefault(s => s.Available);

PHP

<?php
$day = gmdate( 'Y-m-d', time() + DAY_IN_SECONDS );
$response = wp_remote_get( 'https://api.bookdineplay.com/api/venues/your-venue/availability?date=' . $day . '&partySize=4&resourceType=RestaurantTable', [
    'headers' => [ 'X-BookDinePlay-Key' => BOOKDINEPLAY_SECRET_KEY ],
] );
$availability = json_decode( wp_remote_retrieve_body( $response ), true );

Eine leere slots-Liste mit einem notice bedeutet, dass die Location an diesem Tag geschlossen ist; versuchen Sie ein anderes Datum. Nehmen Sie start und resourceId eines verfügbaren Slots für den nächsten Aufruf.

4. Buchen

Senden Sie den Slot mit den Daten des Gastes zurück. Der Header Idempotency-Key macht eine Wiederholung sicher: Wiederholen Sie dieselbe Anfrage nach einem Timeout mit demselben Schlüssel, erhalten Sie die ursprüngliche Reservierung, nie eine zweite.

curl

curl -X POST "https://api.bookdineplay.com/api/venues/your-venue/reservations" \
  -H "X-BookDinePlay-Key: $BOOKDINEPLAY_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "resourceType": "RestaurantTable",
    "resourceId": "table-4a",
    "date": "2026-12-01",
    "start": "19:00",
    "partySize": 4,
    "customerName": "Jana Berger",
    "email": "jana@example.com"
  }'

JavaScript

const response = await fetch('https://api.bookdineplay.com/api/venues/your-venue/reservations', {
  method: 'POST',
  headers: {
    'X-BookDinePlay-Key': process.env.BOOKDINEPLAY_KEY,
    'Idempotency-Key': crypto.randomUUID(),
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    resourceType: 'RestaurantTable', resourceId: slot.resourceId, date: availability.date,
    start: slot.start, partySize: 4, customerName: 'Jana Berger', email: 'jana@example.com'
  })
});
const reservation = await response.json();
console.log(response.status, reservation.reference, reservation.status);

C#

var reservation = await client.CreateReservationAsync("your-venue", new CreateReservationRequest
{
    ResourceType = BookableResourceType.RestaurantTable,
    ResourceId = slot!.ResourceId,
    Date = availability!.Date,
    Start = slot.Start,
    PartySize = 4,
    CustomerName = "Jana Berger",
    Email = "jana@example.com"
}, Guid.NewGuid().ToString(), cancellationToken);
Console.WriteLine($"{reservation.Reference} {reservation.Status}");

PHP

<?php
$response = wp_remote_post( 'https://api.bookdineplay.com/api/venues/your-venue/reservations', [
    'headers' => [
        'X-BookDinePlay-Key' => BOOKDINEPLAY_SECRET_KEY,
        'Idempotency-Key'    => wp_generate_uuid4(),
        'Content-Type'       => 'application/json',
    ],
    'body'    => wp_json_encode( [
        'resourceType' => 'RestaurantTable', 'resourceId' => $slot['resourceId'], 'date' => $availability['date'],
        'start' => $slot['start'], 'partySize' => 4, 'customerName' => 'Jana Berger', 'email' => 'jana@example.com',
    ] ),
] );
$reservation = json_decode( wp_remote_retrieve_body( $response ), true );
echo $reservation['reference'] . ' ' . $reservation['status'];

Die Antwort ist 201 Created mit einer reference (BDP-…), einem status von Confirmed – oder Pending mit depositRequired: true, wenn die Location eine Anzahlung verlangt (Anzahlungen) – und einem cancelToken. Das cURL-Beispiel verwendet zur Lesbarkeit eine feste resourceId und ein festes Datum: Nehmen Sie die Werte aus Schritt 3, oder lassen Sie resourceId weg, damit die API die erste freie Ressource des Typs wählt.

5. Buchung nachschlagen und stornieren

Mit dem cancelToken aus der Antwort brauchen die Zusammenfassung des Gastes und die Storno-Route gar keinen Schlüssel:

curl

curl "https://api.bookdineplay.com/api/reservations/$CANCEL_TOKEN"

JavaScript

const booking = await (await fetch(`https://api.bookdineplay.com/api/reservations/${reservation.cancelToken}`)).json(); // sends no key
console.log(booking.status, booking.canCancel);

C#

var booking = await client.GetReservationAsync(reservation.CancelToken!, cancellationToken); // sends no key
Console.WriteLine($"{booking?.Status} {booking?.CanCancel}");

PHP

<?php
$response = wp_remote_get( 'https://api.bookdineplay.com/api/reservations/' . rawurlencode( $reservation['cancelToken'] ) ); // sends no key
$booking = json_decode( wp_remote_retrieve_body( $response ), true );

curl

curl -X POST "https://api.bookdineplay.com/api/reservations/$CANCEL_TOKEN/cancel"

JavaScript

await fetch(`https://api.bookdineplay.com/api/reservations/${reservation.cancelToken}/cancel`, { method: 'POST' }); // sends no key

C#

var cancelled = await client.CancelReservationAsync(reservation.CancelToken!, cancellationToken); // sends no key

PHP

<?php
wp_remote_post( 'https://api.bookdineplay.com/api/reservations/' . rawurlencode( $reservation['cancelToken'] ) . '/cancel' ); // sends no key

Wenn es nicht funktioniert

  • 401 invalid-api-key. Der Header fehlt, der Schlüssel ist falsch eingegeben oder wurde widerrufen.
  • 403 secret-key-from-browser. Die Anfrage trug zusammen mit einem geheimen Schlüssel einen Origin-Header. Senden Sie geheime Schlüssel nur von Servern.
  • 400. Ein Feld hat die Validierung nicht bestanden; errors im Problem-Body nennt es. Daten sind yyyy-MM-dd, Zeiten HH:mm.
  • 409. Der Slot wurde vergeben, nachdem Sie nachgesehen haben. Fragen Sie die Verfügbarkeit erneut ab.

Fehler listet jeden Problemtyp und was dann zu tun ist.

Nächste Schritte