대기열 토큰 발급

Http

POST /api/v1/queues/token HTTP/1.1
userId: 1
Host: localhost:8080
Content-Type: application/x-www-form-urlencoded

Response

필드명 타입 필수값 양식 설명

result

String

true

요청 성공 여부

data.token

String

true

대기열 토큰

{
  "result" : "SUCCESS",
  "data" : {
    "token" : "token:123"
  },
  "error" : null
}

예약 가능 날짜 조회

Http

GET /api/v1/concerts/1/schedules HTTP/1.1
token: token:123
Host: localhost:8080

Path Variable

필드명 필수값 양식 설명

concertId

true

콘서트 ID

Response

필드명 타입 필수값 양식 설명

result

String

true

요청 성공 여부

data.schedules[].concertScheduleId

Number

true

콘서트 일정 ID

data.schedules[].date

String

true

콘서트 날짜

{
  "result" : "SUCCESS",
  "data" : {
    "schedules" : [ {
      "concertScheduleId" : 1,
      "date" : "2025-01-01"
    }, {
      "concertScheduleId" : 2,
      "date" : "2025-01-02"
    } ]
  },
  "error" : null
}

예약 가능 좌석 조회

Http

GET /api/v1/concerts/schedules/1/seats HTTP/1.1
token: token:123
Host: localhost:8080

Path Variable

필드명 필수값 양식 설명

concertScheduleId

true

콘서트 일정 ID

Response

필드명 타입 필수값 양식 설명

result

String

true

요청 성공 여부

data.seats[].concertSeatId

Number

true

콘서트 좌석 ID

data.seats[].seatNumber

Number

true

콘서트 좌석 번호

{
  "result" : "SUCCESS",
  "data" : {
    "seats" : [ {
      "concertSeatId" : 1,
      "seatNumber" : 11
    }, {
      "concertSeatId" : 2,
      "seatNumber" : 12
    } ]
  },
  "error" : null
}

좌석 예약 요청

Http

POST /api/v1/reservations/concert HTTP/1.1
Content-Type: application/json
token: token:123
Content-Length: 52
Host: localhost:8080

{
  "concertScheduleId" : 1,
  "concertSeatId" : 2
}

Request

필드명 타입 필수값 양식 설명

concertScheduleId

Number

true

콘서트 일정 ID

concertSeatId

Number

true

콘서트 좌석 ID

Response

필드명 타입 필수값 양식 설명

result

String

true

요청 성공 여부

data.reservationId

Number

true

예약 ID

{
  "result" : "SUCCESS",
  "data" : {
    "reservationId" : 1
  },
  "error" : null
}

잔액 조회

Http

GET /api/v1/user-wallets/balance HTTP/1.1
userId: 1
Host: localhost:8080

Response

필드명 타입 필수값 양식 설명

result

String

true

요청 성공 여부

data.userId

Number

true

유저 ID

data.balance

Number

true

잔액

{
  "result" : "SUCCESS",
  "data" : {
    "userId" : 1,
    "balance" : 1000
  },
  "error" : null
}

잔액 충전

Http

PATCH /api/v1/user-wallets/balance HTTP/1.1
Content-Type: application/json
userId: 1
Content-Length: 21
Host: localhost:8080

{
  "amount" : 1000
}

Request

필드명 타입 필수값 양식 설명

amount

Number

true

증액량

Response

필드명 타입 필수값 양식 설명

result

String

true

요청 성공 여부

{
  "result" : "SUCCESS",
  "data" : null,
  "error" : null
}

결제

Http

POST /api/v1/payment/concert HTTP/1.1
Content-Type: application/json
token: token:123
Content-Length: 32
Host: localhost:8080

{
  "concertReservationId" : 1
}

Request

필드명 타입 필수값 양식 설명

concertReservationId

Number

true

콘서트 예약 ID

Response

필드명 타입 필수값 양식 설명

result

String

true

요청 성공 여부

data.paymentHistoryId

Number

true

결제 이력 ID

{
  "result" : "SUCCESS",
  "data" : {
    "paymentHistoryId" : 1
  },
  "error" : null
}