# API로 잠금 관리

## 시나리오

API에서 락다운은 시나리오로 표시됩니다. 각 시나리오에는 `유형` 이라는 필드가 있으며, 이는 해당 목적을 정의합니다. 타사 플랫폼 및 자동화 도구를 사용하여 사용 가능한 락다운 목록 조회, 활성화, 활성 상태인 락다운 해제와 같은 Verkada 시나리오를 프로그래밍 방식으로 관리할 수 있습니다.

***

## Command 구성

#### 조직 수준

{% 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. 선택 **새 키** 를 클릭합니다. **다음.**\
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 감사 로그에서 확인할 수 있습니다.