Entwicklerdokumentation

.NET-Schnellstart

BookDinePlay.Sdk installieren, den Client mit geheimem Schlüssel registrieren und die erste Buchung aus C# machen – freien Tisch finden, reservieren.

Sie fügen das SDK einer .NET-10-Anwendung hinzu, registrieren den Client und buchen einen Tisch aus dem Code. Sie brauchen einen geheimen API-Schlüssel und einen Location-Slug.

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: Kopieren Sie ihn sofort in Ihre Konfiguration, für die lokale Arbeit mit dotnet user-secrets:

dotnet user-secrets set "BookDinePlay:ApiKey" "<your secret key>"

Ein geheimer Schlüssel gilt für jede Route seiner Location, daher gehört er in Konfiguration oder einen Secret-Store – nie in den Quellcode und nie in eine Client-Anwendung. Ein veröffentlichbarer Schlüssel funktioniert im SDK nicht: Die API lehnt ihn ohne Browser-Origin ab.

2. Installieren und registrieren

dotnet add package BookDinePlay.Sdk

In Program.cs:

builder.Services.AddBookDinePlayClient(
    new Uri("https://api.bookdineplay.com"),
    builder.Configuration["BookDinePlay:ApiKey"]!);

Das registriert IBookDinePlayClient zur Injektion. Jede Anfrage trägt den Schlüssel als X-BookDinePlay-Key, und beim Anlegen einer Reservierung setzt das SDK einen Idempotency-Key für Sie, damit ein Wiederholungsversuch im Transport nie doppelt bucht.

3. Die erste Buchung machen

Injizieren Sie IBookDinePlayClient, wo Sie ihn brauchen, und rufen Sie ihn auf. Dieses Beispiel sieht die nächsten zwei Wochen nach dem ersten Tag mit einem freien Tisch für vier durch und bucht ihn in der Demo-Location:

using BookDinePlay.Domain;
using BookDinePlay.Sdk;
using BookDinePlay.Shared.Contracts;

var today = DateOnly.FromDateTime(DateTime.Today);

// Die nächsten zwei Wochen nach dem ersten Tag mit einem freien Tisch für vier durchsehen.
AvailabilityResponse? day = null;
AvailabilitySlotDto? slot = null;
for (var offset = 1; offset <= 14 && slot is null; offset++)
{
    day = await client.GetAvailabilityAsync(
        "demo-sportsbar",
        today.AddDays(offset),
        partySize: 4,
        BookableResourceType.RestaurantTable,
        cancellationToken: cancellationToken);
    slot = day?.Slots.FirstOrDefault(s => s.Available);
}

if (day is null || slot is null)
{
    Console.WriteLine("Nothing free in the next two weeks.");
    return;
}

var reservation = await client.CreateReservationAsync("demo-sportsbar", new CreateReservationRequest
{
    ResourceType = BookableResourceType.RestaurantTable,
    ResourceId = slot.ResourceId,
    Date = day.Date,
    Start = slot.Start,
    PartySize = 4,
    CustomerName = "Jana Berger",
    Email = "jana@example.com",
}, Guid.NewGuid().ToString(), cancellationToken);

Console.WriteLine($"Booked {reservation.Reference} on {reservation.Date} at {reservation.Start} ({reservation.Status})");

Ersetzen Sie demo-sportsbar durch Ihren eigenen Slug, sobald Ihr Schlüssel zu Ihrer Location gehört. Date ist yyyy-MM-dd und Start ist HH:mm, beides in der Ortszeit der Location, genau wie die Verfügbarkeit es geliefert hat. Der Schlüssel als viertes Argument ist der Idempotency-Key: Verwenden Sie denselben Wert für einen Wiederholungsversuch desselben Vorgangs, und die API gibt die ursprüngliche Reservierung zurück statt einer zweiten.

Prüfen, ob es geklappt hat

Das Programm gibt eine Referenz wie BDP-7Q2M4K und Confirmed aus. Die Reservierung steht auch in der Reservierungsliste der Konsole; stornieren Sie sie dort, um den Slot freizugeben. Der Status Pending bedeutet, dass die Location zuerst eine Anzahlung verlangt (Anzahlungen).

Wenn es nicht funktioniert

  • BookDinePlayApiException mit Status 401. Der Schlüssel fehlt, ist falsch eingegeben oder widerrufen, oder der Konfigurationspfad BookDinePlay:ApiKey ist leer.
  • Status 403 und origin-not-allowed. Sie haben auf einem Server einen veröffentlichbaren Schlüssel verwendet. Nehmen Sie einen geheimen.
  • Status 409 bei der Buchung. Jemand hat den Slot zwischen Ihren beiden Aufrufen genommen. Fragen Sie die Verfügbarkeit erneut ab.
  • Nothing free in the next two weeks. Die Demo-Location ist an manchen Tagen geschlossen; versuchen Sie Ihre eigene Location oder weiten Sie die Schleife aus.

Nächste Schritte

  • .NET-SDK – jeder Aufruf: Events, Gutscheine, QR-Bestellung, Specials und die Ausnahmen, die sie werfen.
  • Reservierungen – was die API mit jedem Feld macht.
  • Anzahlungen – eine Anzahlung nehmen, wenn ein Tisch gebucht wird.