방 비활성화

PATCH /admin/machines/{branch}/{room}

룸의 활성/비활성 상태를 토글합니다. 비활성화된 룸은 예약 슬롯 조회 시 disabledRooms에 포함됩니다.

Headers

이름	필수	설명
Content-Type	O	application/json
Cookie	O	관리자 세션 쿠키

Path Parameters

파라미터	타입	필수	설명
branch	String	O	지점 영문명 (지점 코드 참고)
room	String	O	방 번호

Request Body

파라미터	타입	필수	설명
enabled	boolean	O	true: 활성, false: 비활성

비활성화 요청

{
  "enabled": false
}

Response

200 성공

{
  "status": "success",
  "errorType": null,
  "errorCode": null,
  "message": null,
  "data": null
}

403 권한 없음

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

409 예약 존재

비활성화 시 해당 룸에 기존 예약이 있으면 예약 정보와 함께 실패합니다:

{
  "status": "error",
  "errorType": "SettingConflictException",
  "errorCode": null,
  "message": "해당 룸에 예약이 존재하여 비활성화할 수 없습니다.",
  "data": {
    "conflicts": [
      {
        "type": "PAID",
        "status": "DONE",
        "statusDescription": "결제완료",
        "room": "1",
        "name": "홍길동",
        "mobileNum": "01012345678",
        "startTime": "2026/03/05 14:00",
        "endTime": "2026/03/05 16:00",
        "orderId": "ORD-20260305-001"
      }
    ]
  }
}

conflicts 항목

필드	타입	설명
type	String	PAID / WAITING_DEPOSIT / BOOKING / ADMIN_BOOKING / NAVER_BOOKING
status	String	원본 상태 값
statusDescription	String	상태 한글 설명
room	String	방 번호
name	String	예약자 이름
mobileNum	String	휴대폰 번호
startTime	String	시작 시간 (YYYY/MM/DD HH:mm)
endTime	String	종료 시간 (YYYY/MM/DD HH:mm)
orderId	String	주문 ID

비활성화 조건

비활성화 시 해당 룸에 기존 예약이 없어야 합니다. 예약이 존재하면 409 에러와 함께 충돌 예약 목록이 반환됩니다.