> For the complete documentation index, see [llms.txt](https://help.verkada.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.verkada.com/access-control/ja/jin-ji-dui-ying/emergency-lockdown/manage-lockdowns-and-scenarios-via-api.md).

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

サードパーティプラットフォームで Verkada のシナリオを管理する

シナリオは Verkada API を通じてプログラムで管理でき、利用可能なシナリオの一覧表示、1 つのシナリオの有効化、またはアクティブなシナリオの解除が含まれます。 [緊急シナリオ](/access-control/ja/jin-ji-dui-ying/emergency-lockdown.md) は、管理者が有効化してドアのロックと解錠を行い、何かが発生したときに適切な人へ通知できる、あらかじめ構成された緊急対応で、ロックダウン、ホールド、セキュア、避難、シェルター の5種類に分類されています。

***

## Commandの設定

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

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

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

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

#### API キーを生成

{% stepper %}
{% step %}
**Verkada Command で、すべての製品 > 管理 に移動します。**
{% endstep %}

{% step %}
**Org Settings で、API と統合をクリックします。**
{% endstep %}

{% step %}
**API と統合の設定で、API キー > 追加 を選択します。**

a. 選択 **新しいキー** そしてクリック **次へ。**\
b. 一意の名前を入力します。\
c. 下で **エンドポイント**、選択します **アクセスコントロール。**\
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
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

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

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://help.verkada.com/access-control/ja/jin-ji-dui-ying/emergency-lockdown/manage-lockdowns-and-scenarios-via-api.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.