Anmelden um den Slug und den veröffentlichbaren Schlüssel Ihrer Location in jedem Beispiel zu sehen.
Ihr Konto hat noch keine Location, die Beispiele behalten daher ihre Platzhalter. Abmelden
Angemeldet als · . Legen Sie in der Konsole einen veröffentlichbaren Schlüssel an und laden Sie die Seite neu, um ihn hier zu sehen. Abmelden
Angemeldet als · . Die Beispiele zeigen den veröffentlichbaren Schlüssel Ihrer Location. Abmelden
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 keyC#
var cancelled = await client.CancelReservationAsync(reservation.CancelToken!, cancellationToken); // sends no keyPHP
<?php
wp_remote_post( 'https://api.bookdineplay.com/api/reservations/' . rawurlencode( $reservation['cancelToken'] ) . '/cancel' ); // sends no keyWenn 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 einenOrigin-Header. Senden Sie geheime Schlüssel nur von Servern.400. Ein Feld hat die Validierung nicht bestanden;errorsim Problem-Body nennt es. Daten sindyyyy-MM-dd, ZeitenHH: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
- Verfügbarkeit und Reservierungen – jedes Feld, jeder Header und jede Ablehnung der obigen Aufrufe.
- Authentifizierung – Schlüsseltypen, Origins und Schlüsselrotation.
- Rate Limits und Versionierung – was Sie von der API im Lauf der Zeit erwarten dürfen.