Event Ticket Reservation API
이벤트 티켓 예약 API 설계
문제
한 온라인 이벤트 플랫폼에서는 다양한 콘서트와 공연을 진행하며, 사용자는 티켓을 예약할 수 있습니다. 이 플랫폼의 티켓 예약 기능을 위한 API를 설계하세요.
요구사항
사용자는 특정 이벤트의 티켓을 예약할 수 있어야 합니다.
각 이벤트에는 최대 예약 가능한 티켓 수가 존재합니다.
예약이 성공하면 예약 ID가 반환되어야 합니다.
사용자는 자신의 예약을 조회할 수 있어야 합니다.
사용자는 자신의 예약을 취소할 수 있어야 합니다.
예약 취소 시, 해당 티켓은 다시 사용 가능해야 합니다.
단일 사용자당 하나의 이벤트에 대해 하나의 예약만 가능해야 합니다.
1. 기능정의
티켓예약 (POST)
사용자가 이벤트의 티켓을 예약할 수 있음
성공하면 예약 ID반환
좌석이 부족하면 실패
예약조회 (GET)
특정 사용자의 예약 내역 조회 가능
예약 취소 (DELETE)
사용자가 본인의 예약을 취소할 수 있음
취소된 티켓은 다시 사용 가능해야 함
이벤트 정보 조회 (GET)
특정 이벤트의 티켓 잔여 수 조회 가능
2. 엔드포인트 설계
티켓 예약
POST
/events/{eventId}/reservations
예약 조회
GET
/users/{userId}/reverstaions
예약 취소
DELETE
/reservations/{reservationsId}
이벤트 정보 조회
GET
/events/{eventId}
3. 요청/응답 구조 설계
티켓 예약
Req
POST /events/{eventId}/reservations
Content-Type: applicaiton/json
{
"userId": 123
}
Res (Success)
HTTP/1.1 201 Created
Content-Type: application/json
{
"reservationId": 456,
"eventId": 1,
"userId": 123,
"status": "CONFIRMED"
}
Res (Fail)
HTTP/1.1 400 Bad Request
Content-Type: application/json
{
"error": "Tickets are sold out."
}예약 조회
Req
GET /users/{userId}/reservations
Res (Success)
HTTP/1.1 200 OK
[
{
"reservationId": 456,
"eventId": 1,
"eventName": "IU Concert",
"status": "CONFIRMED"
}, ...
]예약 취소
Req
DELETE /reservations/{reservationId}
Res (Success)
HTTP/1.1 200 OK
Content-Type: application/json
{
"message": "Reservation cancelled successfully."
}
Res (Fail)
HTTP/1.1 400 Bad Request
Content-Type: application/json
{
"message": "Cannot find reservation"
}이벤트 정보 조회
Req
GET /events/{eventId}
Res (Success)
HTTP/1.1 200 OK
Content-Type: application/json
{
"eventId": 1,
"eventName": "IU Concert",
"totalTickets": 500,
"availableTickets": 120
}
Res (Fail)
HTTP/1.1 400 Bad Request
Content-Type: application/json
{
"message": "Cannot find event"
}4. DB 모델링
user
id. BIGINT, PK. 유저id
name. VARCHAR(255). 유저 이름
event
id. BIGINT, PK. 이벤트id
name. VARCHAR(255), 이벤트 이름
total_tickets. INT. 전체 티켓 수
availble_tockets. INT. 남은 티켓 수
reservation
id. BIGINT, PK. 예약 ID
user_id. BIGINT, FK. 유저 ID
event_id. BIGINT, FK. 이벤트 ID
status. VARCHAR. 예약 상태(CONFIRMED, CANCELLED)
created_at. TIMESTAMP. 예약 생성일
modified_at. TIMESTAMP. 예약 수정일
5. 아키텍처 고려
Redis, RDB 활용
redis - 수량을 카운트하고 단일 스레드로 동시성 문제를 피하기 위함
rdb - 수량을 카운트하고, 예약 정보를 저장하기 위함
예약 요청
서버에서 요청을 받으면 redis에서 남은 수량 여부를 체크하고 반영합니다.
(수량이 남아있지 않으면 실패 처리 & 응답을 하게 됩니다.)
수량이 남아있다면, eventListener로 db에 비동기적으로 reservation 정보와 남은수량을 저장합니다.
DB반영 실패시: fallback & recovery 패턴을 활용하여, 비동기 처리작업이 실패하면 실패 테이블에 데이터를 저장을 한 후에, batch작업을 통해 업데이트합니다. (실시간 일관성이 깨지는 단점)
Last updated