스케줄 ID로 예약 슬롯 조회
POST/schedule/open/v1/queries/get-reservation-slots-by-schedule-id
@deprecated 신규 개발 시 V2 API를 사용하세요.
스케줄 ID를 기준으로 예약 슬롯을 조회합니다.
- 주로 기존 스케줄의 예약 시간을 변경하는 전 단계에 사용됩니다.
에러 응답
startDateTimeUtc가 ISO 8601 포맷이 아닌경우
{
"status": 400,
"message": "InvalidCommandException",
"className": "InvalidCommandException",
"errorProperties": [
{
"key": "startDateTimeUtc",
"reason": "NotAvailable"
}
]
}
endDateTimeUtc가 ISO 8601 포맷이 아닌경우
{
"status": 400,
"message": "InvalidCommandException",
"className": "InvalidCommandException",
"errorProperties": [
{
"key": "endDateTimeUtc",
"reason": "NotAvailable"
}
]
}
scheduleId가 누락되었거나 포맷이 잘못된 경우
{
"status": 400,
"message": "InvalidCommandException",
"className": "InvalidCommandException",
"errorProperties": [
{
"key": "scheduleId",
"reason": "NotAvailable"
}
]
}
Request
### Content-Type별 요청의 JSON Schema
{
"application/json": {
"schema": {
"required": [
"scheduleId",
"startDateTimeUtc",
"endDateTimeUtc"
],
"type": "object",
"properties": {
"scheduleId": {
"type": "string",
"description": "스케줄 ID",
"format": "object-id"
},
"startDateTimeUtc": {
"type": "string",
"description": "조회 범위 시작 시각",
"format": "date-time"
},
"endDateTimeUtc": {
"type": "string",
"description": "조회 범위 끝 시각",
"format": "date-time"
}
},
"title": "protos.open.GetReservationSlotsByScheduleIdQuery"
}
}
}
Responses
- 200
OK
### Status Code별 응답의 JSON Schema
{
"200": {
"description": "OK",
"content": {
"application/json": {
"schema": {
"required": [
"data"
],
"type": "object",
"properties": {
"data": {
"type": "array",
"items": {
"required": [
"reservationGroupId",
"zone",
"startDateTimeUtc",
"endDateTimeUtc",
"capacity",
"reservationCount"
],
"type": "object",
"properties": {
"reservationGroupId": {
"type": "string",
"description": "예약 그룹 ID"
},
"zone": {
"allOf": [
{
"required": [
"id",
"name"
],
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "구역 ID",
"format": "object-id"
},
"name": {
"type": "string",
"description": "구역 이름"
}
},
"title": "protos.open.ReservationSlotZoneConfiguration"
}
],
"description": "구역 정보"
},
"startDateTimeUtc": {
"type": "string",
"description": "예약 시작 시각 (ISO 8601)",
"format": "date-time"
},
"endDateTimeUtc": {
"type": "string",
"description": "예약 종료 시각 (ISO 8601)",
"format": "date-time"
},
"capacity": {
"type": "integer",
"description": "해당 슬롯의 최대 예약 가능 인원",
"format": "int32"
},
"reservationCount": {
"type": "integer",
"description": "현재 예약된 인원 수",
"format": "int32"
}
},
"title": "protos.open.ReservationSlot"
}
}
},
"title": "protos.open.GetReservationSlotsQueryResponse"
}
}
}
}
}