# Sperrungen über API verwalten

## Szenarien

In der API werden Lockdowns als Szenarien dargestellt. Jedes Szenario umfasst ein `Typ` -Feld, das seinen Zweck definiert. Sie können Verkada-Szenarien programmgesteuert verwalten, z. B. verfügbare Lockdowns auflisten, einen aktivieren oder einen aktiven freigeben, mithilfe von Drittanbieterplattformen und Automatisierungstools.

***

## Command-Konfiguration

#### Organisationsebene

{% stepper %}
{% step %}
**Gehen Sie in Verkada Command zu Alle Produkte > Access.**
{% endstep %}

{% step %}
**Klicken Sie in der linken Navigation auf Zugriffseinstellungen.**
{% endstep %}

{% step %}
**Aktivieren Sie die Option Enable Lockdown and Scenario Control via API.**
{% endstep %}
{% endstepper %}

#### API-Schlüssel generieren

{% stepper %}
{% step %}
**Gehen Sie in Verkada Command zu Alle Produkte > Admin.**
{% endstep %}

{% step %}
**Klicken Sie unter Org-Einstellungen auf API & Integrationen.**
{% endstep %}

{% step %}
**Wählen Sie in den Einstellungen für API & Integration API-Schlüssel > Hinzufügen aus.**

a. Wählen Sie **Neuer Schlüssel** und klicken Sie auf **Weiter.**\
b. Geben Sie einen eindeutigen Namen ein.\
c. Unter **Endpunkte**wählen Sie **Zugriffskontrolle aus.**\
d. Legen Sie die Berechtigungen auf **Lesen/Schreiben**fest.\
e. Legen Sie das Ablaufdatum fest.\
f. Klicken Sie auf **API generieren.**
{% endstep %}
{% endstepper %}

***

## Verfügbare API-Aktionen

Sobald Sie Command so konfiguriert haben, dass die API-Steuerung von Szenarien erlaubt ist, können Sie die folgenden Aktionen ausführen:

* [Szenarien auflisten](https://apidocs.verkada.com/reference/getaccessscenariolistviewv1): Alle konfigurierten Szenarien in Ihrer Organisation abrufen.
* [Ein Szenario aktivieren](https://apidocs.verkada.com/reference/postaccessscenarioactivateviewv1): Ein Szenario programmgesteuert als Reaktion auf ein Ereignis oder eine Bedingung auslösen.
* [Ein Szenario freigeben](https://apidocs.verkada.com/reference/postaccessscenarioreleaseviewv1): Ein aktives Szenario beenden oder deaktivieren.

{% hint style="warning" %}
Siehe [Verkada API-Dokumentation](https://apidocs.verkada.com/reference/access-scenarios) für weitere Details zu bestimmten Access-Control-API-Endpunkten.
{% endhint %}

***

## Ein Szenario per API aktivieren und freigeben

Wenn ein Szenario wie ein Lockdown über die API aktiviert oder freigegeben wird, verhält es sich genauso, als wäre es manuell in Command ausgelöst worden.

Die Verwendung der API zum Aktivieren oder Freigeben eines Szenarios wird:

* Alle konfigurierten Szenario-Aktionen ausführen, z. B. Türen verriegeln, Warnmeldungen auslösen oder AUX-Ausgänge aktivieren.
* Den Status des Szenarios sowohl in der Command-Oberfläche als auch in der Verkada Pass App aktualisieren.
* Ereignisprotokolle für jede Aktion generieren, sichtbar im Ereignisbericht und im Prüfprotokoll von Command.