관리자 도어락 제어

관리자용 도어락 해제 API입니다. 사용자용과 달리 key 파라미터 없이 지점/룸으로 직접 제어합니다.

---

V2 도어락 해제 요청

POST /admin/door/v2/unlock/{branch}/{doorType}/{roomNo?}

Headers

이름	필수	설명
Cookie	O	관리자 세션 쿠키

Path Parameters

파라미터	타입	필수	설명
branch	String	O	지점 영문명 (지점 코드 참고)
doorType	String	O	"front" (현관) 또는 "room" (룸)
roomNo	String	△	방 번호 (doorType=room일 때 필수)

POST /api/admin/door/v2/unlock/Gwanghwamun/front
POST /api/admin/door/v2/unlock/Gwanghwamun/room/3

Response

200 성공

{
  "status": "success",
  "errorType": null,
  "errorCode": null,
  "message": null,
  "data": {
    "requestId": "req-admin-20260305-abc123"
  }
}

data 필드

필드	타입	설명
requestId	String	SSE 구독에 사용할 요청 ID

403 권한 없음

{
  "status": "error",
  "errorType": "AuthorizationException",
  "errorCode": null,
  "message": "해당 지점에 접근 권한이 없습니다.",
  "data": null
}

---

SSE 결과 구독

GET /admin/door/v2/unlock/subscribe

도어락 해제 결과를 실시간으로 수신합니다. 7초 타임아웃.

Query Parameters

파라미터	타입	필수	설명
requestId	String	O	해제 요청에서 받은 ID

GET /api/admin/door/v2/unlock/subscribe?requestId=req-admin-20260305-abc123

Response

Content-Type: text/event-stream

해제 성공

event: door-result
data: {"status":"SUCCESS","device":"front","failoverKey":null}

해제 실패 (PIN 제공)

event: door-result
data: {"status":"FAILED","device":"room_3","failoverKey":"1234"}

503 타임아웃

{
  "status": "error",
  "errorType": "AsyncRequestTimeoutException",
  "errorCode": null,
  "message": "요청 시간이 초과되었습니다.",
  "data": null
}

door-result 필드

필드	타입	Nullable	설명
status	String	N	SUCCESS / FAILED / TIMEOUT
device	String	Y	도어 디바이스명
failoverKey	String	Y	실패 시 PIN 코드

---

V1 도어락 해제 (Deprecated)

POST /admin/door/unlock/{branch}/{doorType}/{roomNo?}

Deprecated

V1 동기 방식은 2026-01-31에 종료되었습니다. V2를 사용하세요.