Buchungs-API — Kostenlose Kalenderplanung mit Verfügbarkeitsslots

Funktionen

Vollwertige Terminplanung ohne den SaaS-Preis.

Service-Konfiguration

Definieren Sie Services mit Dauer, Pufferzeit, Kapazität und Preisgestaltung. Mehrsprachige Namen unterstützt.

Verfügbarkeitsregeln

Legen Sie wöchentliche Regeln nach Wochentag mit Start- und Endzeit fest. Unterstützt Vormittag- und Nachmittagsblöcke pro Tag.

Verfügbarkeitsausnahmen

Überschreiben Sie Regeln für bestimmte Daten — Feiertage, Sonderöffnungszeiten, einmalige Events.

Slot-Generierung

Berechnet algorithmisch verfügbare Zeitfenster aus Ihren Regeln, der Dauer und der Pufferzeit.

Turnstile-Captcha

Bot-Schutz am öffentlichen Buchungsendpunkt über Cloudflare Turnstile.

CSV-Export

Exportieren Sie alle Buchungen als CSV mit Kundendaten, Zeitstempeln und Status.

Anwendungsfälle

Jedes Unternehmen, das Termine plant, kann NexusKit Buchung nutzen.

Beratung & Coaching

Lassen Sie Kunden 30-Minuten- oder 1-Stunden-Sessions gegen Ihre Verfügbarkeit buchen.

Dienstleistungsunternehmen

Salons, Werkstätten, Agenturen — lassen Sie Kunden online einen Zeitfenster wählen.

Team-Planung

Interne Planung für Interviews, Demos oder Sprechstunden mit Gruppenkapazität.

Event-Buchungen

Verwalten Sie kleine Events, Workshops oder Kurse mit Kapazitätsgrenzen und Pufferzeit.

So funktioniert die API

Richten Sie Services ein, konfigurieren Sie Verfügbarkeit und lassen Sie Kunden in drei Schritten buchen.

1. Services erstellen

Definieren Sie Ihre Services mit Dauer, Pufferzeit, Kapazität und Preisgestaltung.

POST /v1/booking/services
{
  "names": { "de": "30-Minuten-Beratung" },
  "durationMin": 30,
  "bufferMin": 10,
  "capacity": 1,
  "priceCents": 5000,
  "currency": "EUR"
}

2. Verfügbarkeit festlegen

Konfigurieren Sie wöchentliche Regeln und datumsbezogene Ausnahmen.

POST /v1/booking/availability
{
  "rules": [
    { "day": 1, "start": "09:00", "end": "12:00" },
    { "day": 1, "start": "14:00", "end": "17:00" }
  ],
  "exceptions": {
    "2025-12-25": null
  }
}

3. Kunden buchen

Öffentliche Endpunkte lassen Kunden verfügbare Slots abrufen und Buchungen erstellen.

GET  /v1/public/booking/services/:id/slots?date=2025-07-15
POST /v1/public/booking/bookings
{
  "serviceId": "...",
  "startsAt": "2025-07-15T09:00:00Z",
  "customer": { "name": "Max", "email": "[email protected]" }
}

FAQ

Unterstützt Booking Zeitzonen?

Ja. Jeder Tenant hat ein Zeitzonen-Feld (Standard UTC). Die Slot-Berechnung verwendet UTC-Zeitstempel, sodass Buchungen zeitzonenübergreifend konsistent sind.

Ist NexusKit Buchung kostenlos?

Ja, innerhalb von Fair-Use-Limits — 5.000 Buchungen pro Monat, 120 Anfragen pro Minute.

Kann ich unterschiedliche Preise pro Service festlegen?

Ja. Jeder Service hat ein priceCents-Feld und Währung (Standard EUR). Setzen Sie es auf null für kostenlose Services.

Wie funktioniert die Gruppenbuchung?

Setzen Sie die Kapazität auf mehr als 1 bei einem Service. Der Slot-Algorithmus erlaubt dann diese Anzahl gleichzeitiger Buchungen pro Zeitfenster.

Kann ich bestimmte Daten blockieren?

Ja. Verwenden Sie Verfügbarkeitsausnahmen, um wöchentliche Regeln für Feiertage, Sonderevents oder einmalige Termine zu überschreiben.

Buchung