API 종류 HTTP API 명 설명
Tickets GET tickets 사용자 티켓 목록 조회
POST tickets 티켓 생성
POST tickets/encrypt/{ticektId} 티켓 암호화된 데이터 생성
DELETE ticekts/{ticketId} 티켓 삭제
PUT ticekts/use 티켓 사용 상태 업데이트
Musicals GET musicals 뮤지컬 목록 조회
GET musicals/{musicalId} 뮤지컬 상세 내역 조회
GET musicals/{musicalId}/seats-availability 특정 날짜의 뮤지컬 좌석 가용성 조회
GET musicals/{musicalId}/dates 특정 뮤지컬의 예약 가능 날짜 목록 조회
GET musicals/schedules/{scheduleId}/seats 특정 공연 일정의 좌석 가용성 조회
Members POST members/register 회원 등록
POST members/login 회원 로그인
POST members/pin-number-verification 회원의 PIN 번호 인증
Accounts GET accounts 계좌 목록 조회
GET accounts/{accountId} 특정 계좌의 상세 정보 조회
GET accounts/{accountId}/transaction-records 특정 계좌의 거래 내역 조회

Tickets

사용자 티켓 목록 조회

Request

GET /tickets HTTP/1.1
Host: localhost:8080
Content-Type: application/json
Authorization: Bearer {JWT}

Response

HTTP/1.1 200 OK
Content-Type: application/json

{
  "result": {
    "items": [
      {
        "id": 1,
        "title": "킹키부츠",
        "ticketStatus": "BOOKED",
        "createdAt": "2024.10.01(화) 12:00",
        "validUntil": "2024.10.17(목) 10:00",
        "cancelUntil": "2024.10.10(목) 10:00",
        "place": "서울 아트센터",
        "scheduleDate": "2024.10.17(목)",
        "startTime": "10:00",
        "posterImageUrl": "https://.../PosterImg1.png",
        "grade": "R",
        "seatNo": 1
      },
      {
        "id": 2,
        "title": "레드북",
        "ticketStatus": "BOOKED",
        "createdAt": "2024.10.02(수) 14:00",
        "validUntil": "2024.10.22(화) 12:00",
        "cancelUntil": "2024.10.15(화) 12:00",
        "place": "대구 문화회관",
        "scheduleDate": "2024.10.22(화)",
        "startTime": "12:00",
        "posterImageUrl": "https://.../PosterImg2.png",
        "grade": "S",
        "seatNo": 101
      }
    ],
    "nextCursor": null
  },
  "resultCode": 200,
  "resultMsg": "OK"
}

티켓 생성

Request

POST /tickets HTTP/1.1
Host: localhost:8080
Content-Type: application/json
Authorization: Bearer {JWT}

{
  "seatId": [1],
  "deviceId": "device123"
}

Response

HTTP/1.1 201 Created
Content-Type: application/json

{
  "result": [
    {
      "id": 3,
      "ticketStatus": "BOOKED",
      "createdAt": "2024-10-03T10:00:00",
      "validUntil": "2024-10-17T10:00:00",
      "cancelUntil": "2024-10-10T10:00:00",
      "deviceId": "device123"
    }
  ],
  "resultCode": 201,
  "resultMsg": "Created"
}