set_appointment_type_status

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

Verhalten und Grenzen

Setzt eine Terminart auf aktiv (die Buchungsseite ist öffentlich und buchbar) oder pausiert (zurück zum Entwurf: die Seite zeigt sie als nicht verfügbar, bestehende Buchungen bleiben). Setzt einen Zustand, schaltet nicht um. Beim Aktivieren prüft Ridian dasselbe wie in der Konsole: öffentlicher Name, verbundener Kalender für Buchungen, Verfügbarkeit und die Grenze aktiver Terminarten im Tarif. Vorher mit dem Nutzer abstimmen, besonders vor dem Aktivieren.

Berechtigungen

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

bookings:write

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."
    },
    "status": {
      "type": "string",
      "enum": [
        "active",
        "paused"
      ]
    }
  },
  "required": [
    "appointment_type_id",
    "status"
  ],
  "additionalProperties": false
}

Ausgabe

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "appointment_type": {
      "type": "object",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {}
    },
    "console_url": {
      "type": "string"
    }
  },
  "required": [
    "appointment_type",
    "console_url"
  ],
  "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