find_booking_slots

Diese Referenz wird aus dem veröffentlichten Werkzeugvertrag erzeugt. Feldnamen und normative Beschreibungen im Schema sind Englisch.

Verhalten und Grenzen

Liefert die buchbaren Startzeiten einer Terminart zwischen from und to (höchstens 31 Tage) als ISO-Zeiten. Verfügbarkeit, Puffer, Grenzen und die Kalender der Gastgeber sind schon berücksichtigt. Ist incomplete true, war der Kalender nicht erreichbar, in den gebucht wird, und es kommen keine Zeiten: nicht buchen, sondern den Nutzer die Verbindung prüfen lassen. Ein nicht lesbarer Kalender für Belegt-Zeiten wird übersprungen; eine Zeit kann dann einen Termin überschneiden, der nur in diesem Kalender steht. Terminarten, die nur über einen Funnel buchbar sind, lassen sich hier nicht buchen.

Berechtigungen

Freigegebene Scopes, Konten, Kalender und Sichtbarkeitsregeln begrenzen den Zugriff. Ein Workspace-Admin erhält dadurch keinen pauschalen Zugriff auf fremde Konten.

bookings:read

Freigaben und Grenzen

Eingabe

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "appointment_type_id": {
      "type": "string",
      "minLength": 1,
      "maxLength": 64,
      "description": "appointment_type_id from list_appointment_types."
    },
    "from": {
      "type": "string",
      "maxLength": 40
    },
    "to": {
      "type": "string",
      "maxLength": 40
    }
  },
  "required": [
    "appointment_type_id",
    "from",
    "to"
  ],
  "additionalProperties": false
}

Ausgabe

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "slots": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "time_zone": {
      "type": [
        "string",
        "null"
      ]
    },
    "duration_minutes": {
      "type": [
        "number",
        "null"
      ]
    },
    "incomplete": {
      "type": "boolean"
    }
  },
  "required": [
    "slots",
    "time_zone",
    "duration_minutes",
    "incomplete"
  ],
  "additionalProperties": false
}

Fehler und Wiederholungen

Prüfe das Werkzeugergebnis auf Fehler. Wiederhole Schreiboperationen nicht blind nach einem Timeout. Prüfe zuerst den aktuellen Ressourcen- oder Sendestatus.

Fehlerbehandlung