FlowCaptainFC
Registrieren

Verfügbarkeit prüfen

API-Referenz für die Prüfung verfügbarer Terminzeitfenster mit natürlichsprachlichen Anfragen.

Verfügbarkeit prüfen

Verfügbare Terminzeitfenster mit einer natürlichsprachlichen Anfrage prüfen.

Endpunkt

POST /api/v1/check-availability

Anfrage-Body

{
  "query": "nächsten Montag Nachmittag"
}
FeldTypErforderlichBeschreibung
querystringJaNatürlichsprachliche Verfügbarkeitsanfrage (Deutsch oder Englisch)

Antwort — Zeitfenster verfügbar

{
  "message": "Am Montag, 3. März sind diese Zeiten verfügbar: 10:00, 11:00, 13:00, 14:00, 15:00.",
  "slots": [
    { "date": "2026-03-03", "time": "10:00", "day": "Montag" },
    { "date": "2026-03-03", "time": "11:00", "day": "Montag" },
    { "date": "2026-03-03", "time": "13:00", "day": "Montag" },
    { "date": "2026-03-03", "time": "14:00", "day": "Montag" },
    { "date": "2026-03-03", "time": "15:00", "day": "Montag" }
  ],
  "status": "available"
}

Antwort — Keine Zeitfenster verfügbar

Wenn die angefragte Zeit vollständig ausgebucht ist, werden alternative Zeitfenster an naheliegenden Tagen vorgeschlagen:

{
  "message": "Leider sind am Montag keine Termine verfügbar. Alternativen: Dienstag, 4. März um 10:00, 11:00, 14:00.",
  "slots": [],
  "alternatives": [
    { "date": "2026-03-04", "time": "10:00", "day": "Dienstag" },
    { "date": "2026-03-04", "time": "11:00", "day": "Dienstag" },
    { "date": "2026-03-04", "time": "14:00", "day": "Dienstag" }
  ],
  "status": "unavailable"
}

Antwort — Feiertag

{
  "message": "Am Montag, 3. Oktober, haben wir wegen des Tags der Deutschen Einheit geschlossen.",
  "status": "holiday",
  "holiday": "Tag der Deutschen Einheit"
}

Antwort — Geschlossen

{
  "message": "Sonntags haben wir geschlossen.",
  "status": "closed"
}

Natürlichsprachliche Beispiele

Das Feld query akzeptiert Freitext auf Deutsch oder Englisch:

  • "nächsten Montag"
  • "morgen um 14 Uhr"
  • "next week Tuesday"
  • "tomorrow afternoon"
  • "Haben Sie am Freitag noch etwas frei?"
  • "Do you have anything on Friday?"

Hinweise

  • Die Antwortsprache passt sich automatisch der Eingabesprache an
  • Pro Anfrage werden bis zu 5 Zeitfenster zurückgegeben
  • Alternative Vorschläge haben einen Abstand entsprechend der Termindauer
  • Wenn Google Kalender vorübergehend nicht erreichbar ist, gibt die API einen Fehler zurück, anstatt anzunehmen, dass der Kalender frei ist