# API 経由でシナリオを管理する

シナリオは、利用可能なシナリオの一覧表示、1つの有効化、またはアクティブなものの解除を含め、Verkada API を通じてプログラムで管理できます。 [緊急シナリオ](/access-control/ja/toarto/configure-access-control-event-alerts/emergency-lockdown.md) 管理者が何か起きた際にドアをロックおよび解錠し、適切な人々に通知するために有効化できる、事前設定された緊急対応であり、ロックダウン、待機、安全確保、避難、シェルターの5種類に分類されています。

***

## コマンド設定

#### オーガナイゼーション'   レベル

{% stepper %}
{% step %}
**Verkada Command で、All Products > Access に移動します。**
{% endstep %}

{% step %}
**左側のナビゲーションで、「アクセス設定」をクリックします。**
{% endstep %}

{% step %}
**API経由で「ロックダウンとシナリオ制御を有効にする」をオンにします。**
{% endstep %}
{% endstepper %}

#### APIキーを生成

{% stepper %}
{% step %}
**Verkada Commandで、All Products > Adminに移動します。**
{% endstep %}

{% step %}
**Org Settings で、API & Integrations をクリックします。**
{% endstep %}

{% step %}
**API & Integration の設定から、API Keys > Add を選択します。**

a. 選択 **New Key** をクリックし **Next.**\
b. 一意の名前を入力します。\
c. Under **Endpoints**、選択 **アクセスコントロール。**\
d. 権限を次に設定します **読み取り/書き込み**.\
e. 有効期限を設定します。\
f. 次をクリックします **API を生成します。**
{% endstep %}
{% endstepper %}

***

## 利用可能な API アクション

Command を設定してシナリオの API 制御を許可すると、次のアクションを実行できます:

* [シナリオの一覧](https://apidocs.verkada.com/reference/getaccessscenariolistviewv1): オーガナイゼーション' 全体で設定されているすべてのシナリオを取得します。
* [シナリオをアクティブ化](https://apidocs.verkada.com/reference/postaccessscenarioactivateviewv1): イベントや条件に応じて、プログラムからシナリオをトリガーします。
* [シナリオを解除する](https://apidocs.verkada.com/reference/postaccessscenarioreleaseviewv1): アクティブなシナリオを終了または無効化します。

{% hint style="warning" %}
参照 [Verkada API ドキュメント](https://apidocs.verkada.com/reference/access-scenarios) アクセスコントロール API エンドポイントの詳細については、
{% endhint %}

***

## API を介してシナリオを有効化および解除する

ロックダウンなどのシナリオが API 経由で有効化または解除されると、Command で手動で有効化された場合と同じように動作します。

API を使用してシナリオを有効化または解除すると、次のことが行われます。

* ドアの施錠、ドアの解錠、アラートのトリガー、AUX 出力の有効化など、設定済みのすべてのシナリオアクションを実行します。
* Command インターフェースと Verkada Pass アプリの両方で、シナリオのステータスを更新します。
* 各アクションのイベントログを生成し、EventsレポートとCommand 監査ログで確認できます。


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://help.verkada.com/access-control/ja/toarto/manage-doors-via-api/manage-lockdowns-and-scenarios-via-api.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
