> 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/ko/integrations-and-alerts/manage-doors-via-api/manage-lockdowns-and-scenarios-via-api.md).

# API로 시나리오 관리하기

시나리오는 Verkada API를 통해 프로그래밍 방식으로 관리할 수 있으며, 사용 가능한 시나리오를 나열하거나, 하나를 활성화하거나, 활성화된 시나리오를 해제하는 작업이 포함됩니다. [비상 시나리오](/access-control/ko/integrations-and-alerts/configure-access-control-event-alerts/emergency-lockdown.md) 는 관리자가 활성화하여 문을 잠그고 잠금을 해제하며, 어떤 일이 발생했을 때 적절한 사람들에게 알릴 수 있는 사전 구성 비상 대응이며, Lockdown, Hold, Secure, Evacuate, Shelter의 다섯 가지 유형으로 구성됩니다.

***

## Command 구성

#### 조직 수준

{% stepper %}
{% step %}
**Verkada Command에서 All Products > Access로 이동합니다.**
{% endstep %}

{% step %}
**왼쪽 탐색에서 Access Settings를 클릭합니다.**
{% endstep %}

{% step %}
**API를 통한 Lockdown 및 시나리오 제어 사용을 켭니다.**
{% endstep %}
{% endstepper %}

#### API 키 생성

{% stepper %}
{% step %}
**Verkada Command에서 모든 제품 > 관리자로 이동합니다.**
{% endstep %}

{% step %}
**조직 설정에서 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를 통해 시나리오 활성화 및 해제

Lockdown과 같은 시나리오가 API를 통해 활성화되거나 해제되면 Command에서 수동으로 활성화한 것과 동일하게 동작합니다.

API를 사용하여 시나리오를 활성화하거나 해제하면 다음이 수행됩니다:

* 문 잠금, 문 잠금 해제, 알림 트리거, AUX 출력 활성화와 같은 구성된 모든 시나리오 작업을 실행합니다.
* Command 인터페이스와 Verkada Pass 앱 모두에서 시나리오 상태를 업데이트합니다.
* 각 작업에 대한 이벤트 로그를 생성하며, 이벤트 보고서와 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 dynamically by asking a question.

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

```
GET https://help.verkada.com/access-control/ko/integrations-and-alerts/manage-doors-via-api/manage-lockdowns-and-scenarios-via-api.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.