Reservation/Room

ward-study 어플리케이션에서 두번째로 중요한 스키마로, 해당룸을 조회, 해당 룸 전체 예약조회와 등록기능을 제공합니다. 예약이 완료된 후 Notification(알람)이 자동으로 사용자들에게 전송됩니다.

Creating a reservation

예약 등록

POST https://api.myapi.com/v1/study-group/{groupId}/room/{roomId}/reservation

Creates a new reservation.

Path Parameters

Name	Type	Description
groupId*	Long
roomId*	Long

Request Body

Name	Type	Description
start_time*	timestamp	The reservation start time
end_time*	timestamp	The reservation end time

200 The reservation successfully created

{
    "name"="Wilson-study",
    "owner": {
        "id": 01,
        "name": "Samuel Passet"},
    "room":{
        "id": 02,
        "name": "044/2,000"
    }    
    "reservation_date": "2022-08-22",
    "start_time": "07:00",
    "end_time": "09:00"
}

401 Permission denied

Getting room reservations

해당 룸 예약 조회

GET https://api.myapi.com/v1/room/{roomId}/reservation

getting stduy-groups.

Path Parameters

Name	Type	Description
roomId*	Long

Query Parameters

Name	Type	Description
start_time*	timestamp
end_time*	timestamp

200 The Room reservation successfully get

{
    "name"="Wilson",
    "owner": {
        "id": "sha7891bikojbkreuy",
        "name": "Samuel Passet",
    "species": "Dog",}
    "breed": "Golden Retriever",
}

401 Permission denied

Getting newsfeed all reservations

해당 유저 예약 조회

GET https://api.myapi.com/v1/user/{userId}/reservation

return all reservation for the user

Path Parameters

Name	Type	Description
userId*	Long

200 The Room reservation successfully get

{
    "name"="Wilson",
    "owner": {
        "id": "sha7891bikojbkreuy",
        "name": "Samuel Passet",
    "species": "Dog",}
    "breed": "Golden Retriever",
}

401 Permission denied

Getting a reservation

등록한 예약 상세보기

GET https://api.myapi.com/v1/room/{roomId}/reservation/{reservationId}

getting a stduy-group

Path Parameters

Name	Type	Description
roomId*	Long
reservationId*	Long

200 Pet successfully created

{
    "name"="Wilson",
    "owner": {
        "id": "sha7891bikojbkreuy",
        "name": "Samuel Passet",
    "species": "Dog",}
    "breed": "Golden Retriever",
}

401 Permission denied

Updating a reservation

예약 수정

PUT https://api.myapi.com/v1/room/{roomId}/reservation/{reservationId}

reservation date, time modify, pk 수정ㅡ?

Request Body

Name	Type	Description
start_time	timestamp	The reservation start time
end_time	timestamp	The reservation end time

200 reservation successfully updated

{
    "name"="Wilson",
    "owner": {
        "id": "sha7891bikojbkreuy",
        "name": "Samuel Passet",
    "species": "Dog",}
    "breed": "Golden Retriever",
}

401 Permission denied

Deleting a reservation

예약 취소

DELETE https://api.myapi.com/v1/reservation/{reservationId}

Path Parameters

Name	Type	Description
reservationId*	Long
roomId*	Long

200 Reservation successfully canceled

{
    "name"="Wilson",
    "owner": {
        "id": "sha7891bikojbkreuy",
        "name": "Samuel Passet",
    "species": "Dog",}
    "breed": "Golden Retriever",
}

401 Permission denied