API docs

📚 콜라보, 쉐어 관련 API

이벤트 전체 조회 & 필터링 조회

• URL

  /api/v1/events

• Method

  GET

• Query String

Parameter	Description	Required or Optional	Default Value	Type
location	지역이름 ex)서울, 부산, 광주	Optional	X	String
type	콜라보 or 쉐어	Optional	X	String
page	0부터 시작	Optional	O	Integer
size	페이지네이션 사이즈	Optional	20	Integer

• Success Response:
  • Code: 200
    
  • Response Body:

{ //데이터가 있는 경우
    "status": 200,
    "message": "이벤트 조회 성공",
    "data": {
        "content": [
            {
                "id": 38,
                "title": "저희 팀과 함께해요!",
                "location": "부산",
                "type": "콜라보",
                "imgUrl": "https://www.culture.go.kr/upload/rdf/22/07/show_2022071814552019267.jpg",
                "deadline": "2023-02-15T19:03:45",
                "createdAt": "2023-03-17T11:47:49.216031",
                "profile": {
                    "id": 13,
                    "name": "1MILLION",
                    "imgUrl": "https://www.culture.go.kr/upload/rdf/22/07/show_2022071814552019267.jpg"
                }
            },
            {
                "id": 36,
                "title": "3월 15일 함께 콜라보 하실분~",
                "location": "서울",
                "type": "콜라보",
                "imgUrl": "https://www.culture.go.kr/upload/rdf/22/07/show_2022071814552019267.jpg",
                "deadline": "2023-03-15T15:00:00",
                "createdAt": "2023-03-04T07:20:20.256283",
                "profile": {
                    "id": 67,
                    "name": "손진영이",
                    "imgUrl": "https://www.culture.go.kr/upload/rdf/22/07/show_2022071814552019267.jpg"
                }
            },
            {
                "id": 24,
                "title": "춤에 대한 지식을 공유하고 싶습니다.",
                "location": "제주",
                "type": "쉐어",
                "imgUrl": "https://www.culture.go.kr/upload/rdf/22/07/show_2022071814552019267.jpg",
                "deadline": "2023-03-07T15:00:00",
                "createdAt": "2023-03-04T03:08:36.18009",
                "profile": {
                    "id": 13,
                    "name": "1MILLION",
                    "imgUrl": "https://www.culture.go.kr/upload/rdf/22/07/show_2022071814552019267.jpg"
                }
            }
        ],
        "numberOfElements": 3,
        "offset": 0,
        "pageNumber": 0,
        "pageSize": 15,
        "totalElements": 3,
        "totalPages": 1
    }
}            

{ // 데이터가 없는 경우 
      "status": 200,
      "message": "이벤트 조회 성공",
      "content": [],
      "offset": 0,       
      "pageNumber": 0,
      "pageSize": 200,
      "totalPages": 1,
      "totalElements": 5,
      "numberOfElements": 5                   
}

이벤트 글 등록

• URL

  /api/v1/events

• Method

  POST

• Header Parameter

Parameter	Description	Required or Optional	Default Value	Type
authorization	서버에서 발급한 access Token	Required	X	String

• Request

  content-Type : application/json

{			
      "title": "저희 팀과 함께해요!", 
      "location": "부산", 
      "type": "콜라보", 
      "imgUrl": "https://www.culture.go.kr/upload/rdf/22/07/show_2022071814552019267.jpg", 
      "recruitType": "댄스팀",  
      "description":"상세정보", 
      "recruitCount": 4 ,
      "deadline": "2023-02-15T19:03:45"
}

• Success Response:
  • Code: 201
    
  • Response Body:

{
    "status": 201,
    "message": "이벤트 등록 성공",
    "data": {
        "id": 38,
        "profile": {
            "id": 13,
            "name": "1MILLION",
            "imgUrl": "https://www.culture.go.kr/upload/rdf/22/07/show_2022071814552019267.jpg"
        },
        "type": "콜라보",
        "title": "저희 팀과 함께해요!",
        "recruitType": "댄스팀",
        "recruitCount": 4,
        "deadline": "2023-02-15T19:03:45",
        "location": "부산",
        "description": "상세정보",
        "imgUrl": "https://www.culture.go.kr/upload/rdf/22/07/show_2022071814552019267.jpg",
        "applied": false
    }
}

이벤트 글 수정

• URL

  /api/v1/events

• Method

  PATCH

• Header Parameter

Parameter	Description	Required or Optional	Default Value	Type
authorization	서버에서 발급한 access Token	Required	X	String

• Request

  content-Type : application/json

{			
      "id": "이벤트 글 Id", 
      "title": "저희 팀과 함께해요!", 
      "location": "부산", 
      "type": "콜라보", 
      "imgUrl": "https://www.culture.go.kr/upload/rdf/22/07/show_2022071814552019267.jpg", 
      "recruitType": "댄스팀",  
      "description":"상세정보", 
      "recruitCount": 4 ,
      "deadline": "2023-02-15T19:03:45"
}

• Success Response:
  • Code: 200
    
  • Response Body:

{
    "status": 200,
    "message": "이벤트 수정 성공",
    "data": {
        "id": 38,
        "profile": {
            "id": 13,
            "name": "1MILLION",
            "imgUrl": "https://www.culture.go.kr/upload/rdf/22/07/show_2022071814552019267.jpg"
        },
        "type": "콜라보",
        "title": "우리 팀에 올래?",
        "recruitType": "댄스팀",
        "recruitCount": 4,
        "deadline": "2023-02-15T19:03:45",
        "location": "부산",
        "description": "상세정보",
        "imgUrl": "https://www.culture.go.kr/upload/rdf/22/07/show_2022071814552019267.jpg",
        "applied": false
    }
}

이벤트 글 조회

• URL

  /api/v1/events/{eventId}

• Method

  GET

• Path Variable

Parameter	Description	Required or Optional	Default Value	Type
eventId	이벤트 글의 고유Id	Required	X	String

• Success Response:
  • Code: 200
    
  • Response Body:

{
    "status": 200,
    "message": "이벤트 상세 조회 성공",
    "data": {
        "id": 38,
        "profile": {
            "id": 13,
            "name": "1MILLION",
            "imgUrl": "https://www.culture.go.kr/upload/rdf/22/07/show_2022071814552019267.jpg"
        },
        "type": "콜라보",
        "title": "우리 팀에 올래?",
        "recruitType": "댄스팀",
        "recruitCount": 4,
        "deadline": "2023-02-15T19:03:45",
        "location": "부산",
        "description": "상세정보",
        "imgUrl": "https://www.culture.go.kr/upload/rdf/22/07/show_2022071814552019267.jpg",
        "applied": false
    }
}

이벤트 글 삭제

• URL

  /api/v1/events/{eventId}

• Method

  DELETE

• Header Parameter

Parameter	Description	Required or Optional	Default Value	Type
authorization	서버에서 발급한 access Token	Required	X	String

• Path Variable

Parameter	Description	Required or Optional	Default Value	Type
eventId	이벤트 글의 고유Id	Required	X	String

• Success Response:
  • Code: 200
    
  • Response Body:

{
    "status": 200,
    "message": "이벤트 삭제 성공"
}

이벤트 조기 마감

• URL

  /api/v1/events/deadline

• Method

  PATCH

• Header Parameter

Parameter	Description	Required or Optional	Default Value	Type
authorization	서버에서 발급한 access Token	Required	X	String

• Request

  content-Type : application/json

{			
      "eventId": "이벤트 글 Id", 
}

• Success Response:
  • Code: 200
    
  • Response Body:

{
    "status": 200,
    "message": "해당 이벤트를 조기 마감하였습니다."
}

📚 콜라보, 쉐어 매칭 관련 API

이벤트 지원

• URL

  /api/v1/events/apply

• Method

  POST

• Header Parameter

Parameter	Description	Required or Optional	Default Value	Type
authorization	서버에서 발급한 access Token	Required	X	String

• Request

  content-Type : application/json

{					
    "eventId": 40
}

• Success Response:
  • Code: 201
    
  • Response Body:

{
    "status": 200,
    "message": "이벤트 매칭 성공"
}

이벤트 지원 취소

• URL

  /api/v1/events/{eventId}/cancel-apply

• Method

  DELETE

• Header Parameter

Parameter	Description	Required or Optional	Default Value	Type
authorization	서버에서 발급한 access Token	Required	X	String

• Path Variable

Parameter	Description	Required or Optional	Default Value	Type
eventId	이벤트 글의 고유Id	Required	X	String

• Success Response:
  • Code: 200
    
  • Response Body:

{
    "status": 200,
    "message": "이벤트 신청 취소 성공"
}

이벤트 신청자 리스트 조회

• URL

  /api/v1/events/{eventId}/applicants

• Method

  GET

• Header Parameter

Parameter	Description	Required or Optional	Default Value	Type
authorization	서버에서 발급한 access Token	Required	X	String

• Success Response:
  • Code: 201
    
  • Response Body:

{
    "status": 200,
    "message": "신청자 리스트 조회 성공",
    "data": [
        {
            "profile": {
                "id": 13,
                "name": "1MILLION",
                "imgUrl": "https://www.culture.go.kr/upload/rdf/22/07/show_2022071814552019267.jpg",
                "description": "저는 춤을 사랑하며, 제 인생의 동반자입니다.\n\n누구나 즐길 수 있는 음악 위에 춤추는걸 좋아합니다.",
                "openChatUrl": "https://open.kakao.com/o/dsfsa232",
                "location": "부산"
            },
            "matched": false
        },
        {
            "profile": {
                "id": 2,
                "name": "무지개고양이",
                "imgUrl": "https://www.culture.go.kr/upload/rdf/22/07/show_2022071814552019267.jpg",
                "description": "어서와냥! 우리 무지개 고양이 팀을 소개할게냥!\n\n우리 팀은 전통있는 스트릿 댄스팀으로서, 우리 멤버들은 다양한 스타일의 댄스를 춤추는 전문가들이다냥. 우리는 댄스를 통해 다양한 감정과 메시지를 전달하며, 관객들을 매료시키는 것을 목표로 노력하고 있다냥! \n\n우리 팀의 특징은 고양이들로 구성되어 있다는 것이다냥. 우리 고양이 멤버들은 우아하면서도 경쾌한 춤을 추며, 관객들의 눈길을 끌어내고 있다냥.",
                "openChatUrl": "https://open.kakao.com/o/gv6J6O7e",
                "location": "부산"
            },
            "matched": true
        }
    ]
}

이벤트 지원자 요청 수락

• URL

  /api/v1/events/{eventId}/accept

• Method

  PATCH

• Header Parameter

Parameter	Description	Required or Optional	Default Value	Type
authorization	서버에서 발급한 access Token	Required	X	String

• Path Variable

Parameter	Description	Required or Optional	Default Value	Type
eventId	이벤트 글의 고유Id	Required	X	String

• Request

  content-Type : application/json

Parameter	Description	Required or Optional	Default Value	Type
memberId	지원자의 멤버 고유 Id	Required	X	Integer

{
    "memberId" :13
}

• Success Response:
  • Code: 200
    
  • Response Body:

{
    "status": 200,
    "message": "신청자 수락 성공"
}

📚 공연 관련 API

공연 전체 조회

• URL

  /api/v1/performances

• Method

  GET

• Success Response:

  • Code: 200
    
  • Response Body:

{
    "status": 200,
    "message": "공연 조회 성공",
    "data": {
        "content": [
            {
                "id": 1006,
                "title": "춤추는 도시, 인천",
                "imgUrl": "https://www.culture.go.kr/upload/rdf/22/07/show_2022071814552019267.jpg",
                "startDate": "2023-03-09T01:35:39",
                "genres": [
                    "기타",
                    "스트릿댄스",
                    "락킹"
                ],
                "location": "인천",
                "profile": {
                    "id": 1003,
                    "name": "DORIS",
                    "imgUrl": "https://www.culture.go.kr/upload/rdf/22/07/show_2022071814552019267.jpg"
                }
            },
            {
                "id": 1005,
                "title": "댄스컬: 사랑하면 춤을 춰라",
                "imgUrl": "https://www.culture.go.kr/upload/rdf/22/07/show_2022071814552019267.jpg",
                "startDate": "2023-03-08T01:29:53",
                "genres": [
                    "힙합",
                    "팝핀",
                    "브레이킹"
                ],
                "location": "대구",
                "profile": {
                    "id": 1002,
                    "name": "SSAMBA",
                    "imgUrl": "https://www.culture.go.kr/upload/rdf/22/07/show_2022071814552019267.jpg"
                }
            },
            {
                "id": 1003,
                "title": "다시 돌아온 저스트절크; 스맨파 도전 그 이후",
                "imgUrl": "https://www.culture.go.kr/upload/rdf/22/07/show_2022071814552019267.jpg",
                "startDate": "2023-03-06T01:11:13",
                "genres": [
                    "힙합"
                ],
                "location": "부산",
                "profile": {
                    "id": 1006,
                    "name": "프라우드먼",
                    "imgUrl": "https://www.culture.go.kr/upload/rdf/22/07/show_2022071814552019267.jpg"
                }
            },
            {
                "id": 1002,
                "title": "훅의 첫 단독 공연",
                "imgUrl": "https://www.culture.go.kr/upload/rdf/22/07/show_2022071814552019267.jpg",
                "startDate": "2023-03-04T16:04:05",
                "genres": [
                    "스트릿댄스",
                    "락킹"
                ],
                "location": "서울",
                "profile": {
                    "id": 1005,
                    "name": "훅",
                    "imgUrl": "https://www.culture.go.kr/upload/rdf/22/07/show_2022071814552019267.jpg"
                }
            },
            {
                "id": 1001,
                "title": "Beenzino The Tour : with Rachica",
                "imgUrl": "https://www.culture.go.kr/upload/rdf/22/07/show_2022071814552019267.jpg",
                "startDate": "2023-03-01T00:59:31",
                "genres": [
                    "힙합"
                ],
                "location": "부산",
                "profile": {
                    "id": 1004,
                    "name": "라치카",
                    "imgUrl": "https://www.culture.go.kr/upload/rdf/22/07/show_2022071814552019267.jpg"
                }
            }
        ],
        "numberOfElements": 5,
        "offset": 0,
        "pageNumber": 0,
        "pageSize": 15,
        "totalElements": 5,
        "totalPages": 1
    }
}           

{ // 데이터가 없는 경우 
      "status": 200,
      "message": "이벤트 조회 성공",
      "content": [],
      "offset": 0,       
      "pageNumber": 0,
      "pageSize": 200,
      "totalPages": 1,
      "totalElements": 5,
      "numberOfElements": 5                   
}

공연 글 등록

• URL

  /api/v1/performances

• Method

  POST

• Request

  content-Type : application/json

Parameter	Description	Required or Optional	Default Value	Type
Header parameter	authorization	Required	X	String

{
    "title": "공연제목", 
    "location": "공연지역", 
    "address" : "공연 상세 주소",
    "startDate": "2023-02-15", 
    "startTime" : "2023-02-15T19:03:45", 
    "genres": ["걸스힙합", "팝핀", "왁킹"],
    "imgUrl": "https://www.culture.go.kr/upload/rdf/22/07/show_2022071814552019267.jpg",
    "description": "공연상세설명"
}

• Success Response:
  • Code: 201
    
  • Response Body:

{
    "status": 201,
    "message": "공연 등록 성공",
    "data": {
        "id": 36,
        "title": "공연제목",
        "imgUrl": "https://www.culture.go.kr/upload/rdf/22/07/show_2022071814552019267.jpg",
        "startDate": "2023-02-15",
        "startTime": "2023-02-15T19:03:45",
        "location": "공연지역",
        "genres": [
            "걸스힙합",
            "팝핀",
            "왁킹"
        ],
        "description": "공연상세설명",
        "address": "공연 상세 주소",
        "profile": {
            "id": 13,
            "name": "1MILLION",
            "imgUrl": "https://www.culture.go.kr/upload/rdf/22/07/show_2022071814552019267.jpg"
        }
    }
}

공연 글 수정

• URL

  /api/v1/events

• Method

  PATCH

• Request

  content-Type : application/json

Parameter	Description	Required or Optional	Default Value	Type
Header parameter	authorization	Required	X	String

 {
	"id": "공연 글 Id",
	"title": "공연제목", 
	"imgUrl": "https://www.culture.go.kr/upload/rdf/22/07/show_2022071814552019267.jpg", 
	"startDate": "2023-02-15", 
	"startTime" : "2023-02-15T19:03:45", 
	"location": "공연지역", 
	"genres": ["발레", "힙합"],
	"description": "공연상세설명", 
	"address" : "공연 상세 주소"
}

• Success Response:
  • Code: 200
    
  • Response Body:

{
    "status": 200,
    "message": "공연 수정 성공",
    "data": {
        "id": 36,
        "title": "공연제목",
        "imgUrl": "https://www.culture.go.kr/upload/rdf/22/07/show_2022071814552019267.jpg",
        "startDate": "2023-02-15",
        "startTime": "2023-02-15T19:03:45",
        "location": "공연지역",
        "genres": [
             "발레" ,
             "힙합"
         ],
        "description": "공연상세설명",
        "address": "공연 상세 주소",
        "profile": {
            "id": 13,
            "name": "1MILLION",
            "imgUrl": "https://www.culture.go.kr/upload/rdf/22/07/show_2022071814552019267.jpg"
        }
    }
}

공연 글 조회

• URL

  /api/v1/events/{performId}

• Method

  GET

• Path Variable

Parameter	Description	Required or Optional	Default Value	Type
performId	공연 글의 고유Id	Required	X	integer

• Success Response:
  • Code: 200
    
  • Response Body:

{
    "status": 200,
    "message": "공연 상세조회 성공",
    "data": {
        "id": 36,
        "title": "공연제목",
        "imgUrl": "https://www.culture.go.kr/upload/rdf/22/07/show_2022071814552019267.jpg",
        "startDate": "2023-02-15",
        "startTime": "2023-02-15T19:03:45",
        "location": "공연지역",
        "genres": [
            "힙합",
            "발레"
        ],
        "description": "공연상세설명",
        "address": "공연 상세 주소",
        "profile": {
            "id": 13,
            "name": "1MILLION",
            "imgUrl": "https://www.culture.go.kr/upload/rdf/22/07/show_2022071814552019267.jpg"
        }
    }
}

공연 글 삭제

• URL

  /api/v1/events/{performId}

• Method

  DELETE

• Path Variable

Parameter	Description	Required or Optional	Default Value	Type
performId	공연 글의 고유Id	Required	X	String

• Success Response:
  • Code: 200
    
  • Response Body:

{
    "status": 200,
    "message": "공연 삭제 성공"
}

공연 글 삭제

• URL

  /api/v1/performances/{performId}

• Method

  DELETE

• Path Variable

Parameter	Description	Required or Optional	Default Value	Type
performId	공연 글의 고유Id	Required	X	Integer

• Success Response:
  • Code: 200
    
  • Response Body:

{
    "status": 200,
    "message": "공연 삭제 성공"
}

공연 팀 이름 검색

• URL

  /api/v1/performances

• Method

  GET

• Query String

Parameter	Description	Required or Optional	Default Value	Type
team	공연 주최자 이름 ex)'팀1' 검색, '팀1'이 주최자인 공연 정보가 나옵니다.	Required	X	String

• Success Response:
  • Code: 200
    
  • Response Body:

{
    "status": 200,
    "message": "팀 이름으로 공연 조회 성공",
    "data": {
        "comming": [
            {
                "id": 33,
                "title": "3월 24일 홍대에서 공연합니다",
                "imgUrl": "https://www.culture.go.kr/upload/rdf/22/07/show_2022071814552019267.jpg",
                "startDate": "2023-03-24T00:29:00",
                "genres": [
                    "커버댄스",
                    "힙합"
                ],
                "location": "서울",
                "profile": {
                    "id": 13,
                    "name": "1MILLION",
                    "imgUrl": "https://www.culture.go.kr/upload/rdf/22/07/show_2022071814552019267.jpg"
                }
            },
            {
                "id": 34,
                "title": "3월 23일날 공연합니다",
                "imgUrl": "https://www.culture.go.kr/upload/rdf/22/07/show_2022071814552019267.jpg",
                "startDate": "2023-03-23T00:00:00",
                "genres": [
                    "힙합"
                ],
                "location": "부산",
                "profile": {
                    "id": 13,
                    "name": "1MILLION",
                    "imgUrl": "https://www.culture.go.kr/upload/rdf/22/07/show_2022071814552019267.jpg"
                }
            }
        ],
        "ended": [
            {
                "id": 35,
                "title": "공연제목",
                "imgUrl": "https://www.culture.go.kr/upload/rdf/22/07/show_2022071814552019267.jpg",
                "startDate": "2023-02-15T19:03:45",
                "genres": [
                    "걸스힙합",
                    "왁킹",
                    "팝핀"
                ],
                "location": "공연지역",
                "profile": {
                    "id": 13,
                    "name": "1MILLION",
                    "imgUrl": "https://www.culture.go.kr/upload/rdf/22/07/show_2022071814552019267.jpg"
                }
            },
            {
                "id": 36,
                "title": "공연제목",
                "imgUrl": "https://www.culture.go.kr/upload/rdf/22/07/show_2022071814552019267.jpg",
                "startDate": "2023-02-15T19:03:45",
                "genres": [
                    "힙합",
                    "발레"
                ],
                "location": "공연지역",
                "profile": {
                    "id": 13,
                    "name": "1MILLION",
                    "imgUrl": "https://www.culture.go.kr/upload/rdf/22/07/show_2022071814552019267.jpg"
                }
            }
        ]
    }
}

📚 후기 관련 API

공연 후기 전체 조회

• URL

  /api/v1/performances/{performId}/reviews

• Method

  GET

• Path Variable

Parameter	Description	Required or Optional	Default Value	Type
performId	상세조회하는 공연글 고유 Id	Required	X	Integer

• Success Response:
  • Code: 200
    
  • Response Body:

{
    "status": 200,
    "message": "리뷰 조회에 성공했습니다.",
    "data": [
        {
            "reviewId": 27,
            "content": "멋진 공연이었어여~",
            "hasProfile": true,
            "createdDate": "2023-03-04T07:27:52.92434",
            "writer": {
                "id": 13,
                "name": "랄랄"
            }
        },
        {
            "reviewId": 25,
            "content": "저 무대에서는 실력있는 댄서들이 엄청난 퍼포먼스를 선보였어냥. 강렬한 음악과 함께, 그들의 완벽한 싱크로율과 다이내믹한 움직임을 보며 나는 놀라움을 금치 못했어냥.",
            "hasProfile": true,
            "createdDate": "2023-03-04T03:05:26.324066",
            "writer": {
                "id": 2,
                "name": "무지개고양이"
            }
        },
        {
            "reviewId": 1002,
            "content": "이번 공연에서는 댄스 뿐 아니라 노래도 함께 부르는 장면들이 많아서 더욱 즐거웠어요! 또한 무대 연출과 조명, 음향까지 완벽하게 구성돼서 몰입도 높게 즐길 수 있었습니다.",
            "hasProfile": true,
            "createdDate": "2023-03-04T02:03:11",
            "writer": {
                "id": 1001,
                "name": "HANWA"
            }
        },
        {
            "reviewId": 1001,
            "content": "항상 멋진 댄스 퍼포먼스를 보여주는데, 이번 라이브 공연에서도 댄서들의 에너지와 열정이 넘쳤습니다! 무대 위에서 표현하는 감정과 실력, 그리고 팀워크까지 모두 완벽해서 너무 인상 깊었습니다.",
            "hasProfile": true,
            "createdDate": "2023-03-03T02:01:40",
            "writer": {
                "id": 1002,
                "name": "SSAMBA"
            }
        },
        {
            "reviewId": 1003,
            "content": "댄서들의 힙합 댄스는 정말 멋있고 힘차게 보여서 끝까지 집중해서 관람했습니다. 또한 각각의 댄서들이 팀워크를 통해 하나로 통합되어서 쇼를 완성하는 모습이 인상적이었습니다.",
            "hasProfile": true,
            "createdDate": "2023-03-02T02:03:41",
            "writer": {
                "id": 1003,
                "name": "DORIS"
            }
        }
    ]
}          

공연 후기 등록

• URL

  /api/v1/performances/{performId}/reviews

• Method

  POST

• Header Parameter

Parameter	Description	Required or Optional	Default Value	Type
authorization	서버에서 발급한 access Token	Required	X	String

• Request

  content-Type : application/json

{
	"review": "랄라라라라"
}

• Success Response:
  • Code: 201
    
  • Response Body:

{
    "status": 201,
    "message": "리뷰가 성공적으로 등록되었습니다.",
    "data": [
        {
            "reviewId": 29,// 등록된 후기글
            "content": "랄라라라라",
            "hasProfile": true,
            "createdDate": "2023-03-17T16:22:49.290256",
            "writer": {
                "id": 13,
                "name": "랄랄"
            }
        },
        {
            "reviewId": 27,
            "content": "멋진 공연이었어여~",
            "hasProfile": true,
            "createdDate": "2023-03-04T07:27:52.92434",
            "writer": {
                "id": 13,
                "name": "랄랄"
            }
        },
        {
            "reviewId": 25,
            "content": "저 무대에서는 실력있는 댄서들이 엄청난 퍼포먼스를 선보였어냥. 강렬한 음악과 함께, 그들의 완벽한 싱크로율과 다이내믹한 움직임을 보며 나는 놀라움을 금치 못했어냥.",
            "hasProfile": true,
            "createdDate": "2023-03-04T03:05:26.324066",
            "writer": {
                "id": 2,
                "name": "무지개고양이"
            }
        },
        {
            "reviewId": 1002,
            "content": "이번 공연에서는 댄스 뿐 아니라 노래도 함께 부르는 장면들이 많아서 더욱 즐거웠어요! 또한 무대 연출과 조명, 음향까지 완벽하게 구성돼서 몰입도 높게 즐길 수 있었습니다.",
            "hasProfile": true,
            "createdDate": "2023-03-04T02:03:11",
            "writer": {
                "id": 1001,
                "name": "HANWA"
            }
        },
        {
            "reviewId": 1001,
            "content": "항상 멋진 댄스 퍼포먼스를 보여주는데, 이번 라이브 공연에서도 댄서들의 에너지와 열정이 넘쳤습니다! 무대 위에서 표현하는 감정과 실력, 그리고 팀워크까지 모두 완벽해서 너무 인상 깊었습니다.",
            "hasProfile": true,
            "createdDate": "2023-03-03T02:01:40",
            "writer": {
                "id": 1002,
                "name": "SSAMBA"
            }
        },
        {
            "reviewId": 1003,
            "content": "댄서들의 힙합 댄스는 정말 멋있고 힘차게 보여서 끝까지 집중해서 관람했습니다. 또한 각각의 댄서들이 팀워크를 통해 하나로 통합되어서 쇼를 완성하는 모습이 인상적이었습니다.",
            "hasProfile": true,
            "createdDate": "2023-03-02T02:03:41",
            "writer": {
                "id": 1003,
                "name": "DORIS"
            }
        }
    ]
}

후기 수정

• URL

  /api/v1/performances/reviews

• Method

  PATCH

• Header Parameter

Parameter	Description	Required or Optional	Default Value	Type
authorization	서버에서 발급한 access Token	Required	X	String

• Request

  content-Type : application/json

{
    "id": 29,
    "review": "시간이 가는 줄도 모르고 빠져들었어요"
}

• Success Response:
  • Code: 200
    
  • Response Body:

{
    "status": 200,
    "message": "리뷰가 성공적으로 수정되었습니다.",
    "data": {
        "reviewId": 29,
        "content": "시간이 가는 줄도 모르고 빠져들었어요",
        "hasProfile": true,
        "createdDate": "2023-03-17T16:22:49.290256",
        "writer": {
            "id": 13,
            "name": "랄랄"
        }
    }
}

후기 삭제

• URL

  /api/v1/performances/reviews/{reviewId}

• Method

  DELETE

• Header Parameter

Parameter	Description	Required or Optional	Default Value	Type
authorization	서버에서 발급한 access Token	Required	X	String

• Path Variable

Parameter	Description	Required or Optional	Default Value	Type
reviewId	후기의 고유Id	Required	X	String

• Success Response:
  • Code: 200
    
  • Response Body:

{
    "status": 200,
    "message": "리뷰가 성공적으로 삭제되었습니다."
}

최근 등록된 후기 6개 조회

• URL

  /api/v1/performances/recent/reviews

• Method

  GET

• Success Response:

  • Code: 200
    
  • Response Body:

{
    "status": 200,
    "message": "최근 리뷰 조회에 성공했습니다.",
    "data": [
        {
            "reviewId": 30,
            "content": "랄라라라라",
            "hasProfile": true,
            "createdDate": "2023-03-17T16:39:00.18834",
            "writer": {
                "id": 13,
                "name": "랄랄"
            },
            "performance": {
                "id": 38,
                "title": "엄청난 퍼포먼스, 시선을 사로잡는 화려함",
                "imgUrl": "https://www.culture.go.kr/upload/rdf/22/07/show_2022071814552019267.jpg"
            }
        },
        {
            "reviewId": 28,
            "content": "너와 나의 연결고리",
            "hasProfile": true,
            "createdDate": "2023-03-08T20:25:39.716997",
            "writer": {
                "id": 13,
                "name": "랄랄"
            },
            "performance": {
                "id": 32,
                "title": "3월 6일날 공연합니다!",
                "imgUrl": "https://www.culture.go.kr/upload/rdf/22/07/show_2022071814552019267.jpg"
            }
        },
        {
            "reviewId": 27,
            "content": "멋진 공연이었어여~",
            "hasProfile": true,
            "createdDate": "2023-03-04T07:27:52.92434",
            "writer": {
                "id": 13,
                "name": "랄랄"
            },
            "performance": {
                "id": 1001,
                "title": "Beenzino The Tour : with Rachica",
                "imgUrl": "https://www.culture.go.kr/upload/rdf/22/07/show_2022071814552019267.jpg"
            }
        },
        {
            "reviewId": 25,
            "content": "저 무대에서는 실력있는 댄서들이 엄청난 퍼포먼스를 선보였어냥. 강렬한 음악과 함께, 그들의 완벽한 싱크로율과 다이내믹한 움직임을 보며 나는 놀라움을 금치 못했어냥.",
            "hasProfile": true,
            "createdDate": "2023-03-04T03:05:26.324066",
            "writer": {
                "id": 2,
                "name": "무지개고양이"
            },
            "performance": {
                "id": 1001,
                "title": "Beenzino The Tour : with Rachica",
                "imgUrl": "https://www.culture.go.kr/upload/rdf/22/07/show_2022071814552019267.jpg"
            }
        },
        {
            "reviewId": 1004,
            "content": "정말 최고의 공연이였습니다. 카메라로 계속 찍는다고 정신이 없었어요!! 그만큼 인상 깊었던 공연이였습니다.",
            "hasProfile": true,
            "createdDate": "2023-03-04T03:03:41",
            "writer": {
                "id": 1001,
                "name": "HANWA"
            },
            "performance": {
                "id": 1007,
                "title": "이번 공연 쉽지 않다!",
                "imgUrl": "https://www.culture.go.kr/upload/rdf/22/07/show_2022071814552019267.jpg"
            }
        },
        {
            "reviewId": 1005,
            "content": "댄서분들의 실력은 정말 뛰어나요!! 공연 시간 끝나는줄 모르고 즐겼어요!!",
            "hasProfile": true,
            "createdDate": "2023-03-04T03:02:41",
            "writer": {
                "id": 1002,
                "name": "SSAMBA"
            },
            "performance": {
                "id": 1008,
                "title": "재치있는 무대로 준비했습니다!",
                "imgUrl": "https://www.culture.go.kr/upload/rdf/22/07/show_2022071814552019267.jpg"
            }
        }
    ]
}

📚 프로필 관련 API

프로필 6개 랜덤 조회

• URL

  /api/v1/profiles/home

• Method

  GET

• Success Response:

  • Code: 200
    
  • Response Body:

{
    "status": 200,
    "message": "프로필 6개 랜덤 조회 성공",
    "data": [
        {
            "id": 13,
            "name": "1MILLION",
            "imgUrl": "https://www.culture.go.kr/upload/rdf/22/07/show_2022071814552019267.jpg",
            "type": "댄서"
        },
        {
            "id": 1001,
            "name": "HANWA",
            "imgUrl": "https://www.culture.go.kr/upload/rdf/22/07/show_2022071814552019267.jpg",
            "type": "댄서"
        },
        {
            "id": 1003,
            "name": "DORIS",
            "imgUrl": "https://www.culture.go.kr/upload/rdf/22/07/show_2022071814552019267.jpg",
            "type": "댄서"
        },
        {
            "id": 1006,
            "name": "프라우드먼",
            "imgUrl": "https://www.culture.go.kr/upload/rdf/22/07/show_2022071814552019267.jpg",
            "type": "댄스팀"
        },
        {
            "id": 67,
            "name": "손진영이",
            "imgUrl": "https://www.culture.go.kr/upload/rdf/22/07/show_2022071814552019267.jpg",
            "type": "댄서"
        },
        {
            "id": 1005,
            "name": "훅",
            "imgUrl": "https://www.culture.go.kr/upload/rdf/22/07/show_2022071814552019267.jpg",
            "type": "댄스팀"
        }
    ]
}           

다른 사용자의 프로필 상세 조회

• URL

  /api/v1/profiles/{memberId}

• Method

  GET

• Path Variable

Parameter	Description	Required or Optional	Default Value	Type
memberId	프로필을 가지는 member의 고유 Id	Required	X	Integer

• Success Response:
  • Code: 201
    
  • Response Body:

{
    "status": 200,
    "message": "프로필 상세 조회 성공",
    "data": {
        "id": 1006,
        "name": "루이",
        "email": "[email protected]",
        "imgUrl": "https://lh3.googleusercontent.com/a/AGNmyxYu491qWIU1A6-1y9AqTtLTfKswd-3JZyar0l5HPA=s96-c",
        "profile": {
            "id": 1006,
            "type": "댄스팀",
            "name": "프라우드먼",
            "imgUrl": "https://www.culture.go.kr/upload/rdf/22/07/show_2022071814552019267.jpg",
            "location": "울산",
            "genres": [],
            "careerStartDate": "2020-03-26",
            "description": "'프라우드먼'라는 이름으로 활동하고 있는 저희 댄스팀은 6명의 멤버로 구성되어 있습니다. K-pop, 힙합, 락 등 다양한 음악에 맞춰 다채로운 무대를 선보입니다. 무대 위에서의 퍼포먼스는 물론이고, 음악과 무대 디자인, 영상 등 전반적인 공연 구성도 완벽합니다. 국내외 다양한 공연장에서 활동하며, 매년 많은 팬들이 기다리는 단독 콘서트도 열고 있습니다.",
            "openChatUrl": "https://open.kakao.com/o/s4SHqsBe",
            "portfolio": {
                "youtube": "https://www.youtube.com/@user-hu8on9zg9f",
                "instagram": "https://www.instagram.com/monika_shin/",
                "tiktok": "https://www.tiktok.com/tag/%EB%AA%A8%EB%8B%88%EC%B9%B4?lang=ko-KR"
            }
        }
    }
}

프로필 등록

• URL

  /api/v1/profiles

• Method

  POST

• Header Parameter

Parameter	Description	Required or Optional	Default Value	Type
authorization	서버에서 발급한 access Token	Required	X	String

• Request

  content-Type : application/json

{					
	"name": "랄랄", 
	"location": "부산", 
	"type": "댄서", 
	"imgUrl": "https://www.culture.go.kr/upload/rdf/22/07/show_2022071814552019267.jpg", 
        "genres": ["발레", "힙합"],
	"description":"저는 춤을 사랑하며, 제 인생의 동반자입니다. 누구나 즐길 수 있는 음악 위에 춤추는걸 좋아합니다.", 
	"openChatUrl": "[email protected]",
        "portfolio": {
           "youtube": null,
           "tiktok": null,
           "instagram": null
        },
	"careerStartDate": "2023-02-15"
}

• Success Response:
  • Code: 201
    
  • Response Body:

{
    "status": 201,
    "message": "프로필 등록 성공",
    "data": {
        "id": 13,
        "type": "댄서",
        "name": "랄랄",
        "imgUrl": "https://www.culture.go.kr/upload/rdf/22/07/show_2022071814552019267.jpg",
        "location": "부산",
        "genres": [
            "힙합",
            "발레"
        ],
        "careerStartDate": "2023-02-15",
        "description": "저는 춤을 사랑하며, 제 인생의 동반자입니다. 누구나 즐길 수 있는 음악 위에 춤추는걸 좋아합니다.",
        "openChatUrl": "[email protected]",
        "portfolio": {
            "youtube": null,
            "instagram": null,
            "tiktok": null
        }
    }
}

프로필 수정

• URL

  /api/v1/profiles

• Method

  PATCH

• Header Parameter

Parameter	Description	Required or Optional	Default Value	Type
authorization	서버에서 발급한 access Token	Required	X	String

• Request

  content-Type : application/json

{					
    "id": 13,
    "name": "soso", 
    "location": "부산", 
    "type": "댄스팀", 
    "imgUrl": "[email protected]", 
    "genres": ["왁킹", "힙합"],
    "description": "저는 춤을 사랑하며, 제 인생의 동반자입니다. 누구나 즐길 수 있는 음악 위에 춤추는걸 좋아합니다.", 
    "openChatUrl": "[email protected]",
    "portfolio": {
        "youtube": null,
        "instagram": null,
        "tiktok": null
    },
    "careerStartDate": "2023-02-15"
}

• Success Response:
  • Code: 200
    
  • Response Body:

{
    "status": 200,
    "message": "프로필 수정 성공",
    "data": {
        "id": 13,
        "type": "댄스팀",
        "name": "soso",
        "imgUrl": "[email protected]",
        "location": "부산",
        "genres": [
            "왁킹",
            "힙합"
        ],
        "careerStartDate": "2023-02-15",
        "description": "저는 춤을 사랑하며, 제 인생의 동반자입니다. 누구나 즐길 수 있는 음악 위에 춤추는걸 좋아합니다.",
        "openChatUrl": "[email protected]",
        "portfolio": {
            "youtube": null,
            "instagram": null,
            "tiktok": null
        }
    }
}

프로필 삭제

• URL

  /api/v1/profiles

• Method

  DELETE

• Header Parameter

Parameter	Description	Required or Optional	Default Value	Type
authorization	서버에서 발급한 access Token	Required	X	String

• Success Response:
  • Code: 200
    
  • Response Body:

{
    "status": 200,
    "message": "프로필 삭제 성공"
}

📚 활동 내역 관련 API

자신이 작성한 후기 조회

• URL

  /api/v1/mypage/performances/reviews

• Method

  GET

• Header Parameter

Parameter	Description	Required or Optional	Default Value	Type
authorization	서버에서 발급한 access Token	Required	X	String

• Success Response:
  • Code: 200
    
  • Response Body:

{
    "status": 200,
    "message": "작성 후기 조회 성공",
    "data": [
        {
            "reviewId": 28,
            "content": "너와 나의 연결고리",
            "createdDate": "2023-03-08T20:25:39.716997",
            "performance": {
                "id": 32,
                "title": "3월 6일날 공연합니다!"
            }
        },
        {
            "reviewId": 27,
            "content": "멋진 공연이었어여~",
            "createdDate": "2023-03-04T07:27:52.92434",
            "performance": {
                "id": 1001,
                "title": "Beenzino The Tour : with Rachica"
            }
        }
    ]
}            

자신이 작성한 공연 조회

• URL

  /api/v1/mypage/performances

• Method

  GET

• Header Parameter

Parameter	Description	Required or Optional	Default Value	Type
authorization	서버에서 발급한 access Token	Required	X	String

• Success Response:
  • Code: 200
    
  • Response Body:

{
    "status": 200,
    "message": "작성한 공연 조회 성공",
    "data": [
        {
            "id": 38,
            "createdDate": "2023-03-17T15:59:30.436992",
            "imgUrl": "https://www.culture.go.kr/upload/rdf/22/07/show_2022071814552019267.jpg",
            "title": "엄청난 퍼포먼스, 시선을 사로잡는 화려함",
            "profile": {
                "name": "랄랄"
            }
        },
        {
            "id": 37,
            "createdDate": "2023-03-17T15:58:22.814942",
            "imgUrl": "https://www.culture.go.kr/upload/rdf/22/07/show_2022071814552019267.jpg",
            "title": "공연제목",
            "profile": {
                "name": "랄랄"
            }
        }
    ]
}          

자신이 작성한 이벤트 조회

• URL

  /api/v1/mypage/events

• Method

  GET

• Header Parameter

Parameter	Description	Required or Optional	Default Value	Type
authorization	서버에서 발급한 access Token	Required	X	String

• Success Response:
  • Code: 200
    
  • Response Body:

{
    "status": 200,
    "message": "작성한 이벤트 조회 성공",
    "data": [
        {
            "id": 42,
            "createdAt": "2023-03-17T16:05:37.617663",
            "imgUrl": "https://www.culture.go.kr/upload/rdf/22/07/show_2022071814552019267.jpg",
            "title": "자신만의 프리스타일 댄스 구상 세미나 개최",
            "type": "쉐어",
            "profile": {
                "name": "랄랄"
            },
            "matched": false
        },
        {
            "id": 41,
            "createdAt": "2023-03-17T16:04:47.40369",
            "imgUrl": "https://www.culture.go.kr/upload/rdf/22/07/show_2022071814552019267.jpg",
            "title": "콜라보 같이 하실분있나요?!",
            "type": "콜라보",
            "profile": {
                "name": "랄랄"
            },
            "matched": false
        }
    ]
}          

자신이 지원한 이벤트 조회

• URL

  /api/v1/mypage/events/applications

• Method

  GET

• Header Parameter

Parameter	Description	Required or Optional	Default Value	Type
authorization	서버에서 발급한 access Token	Required	X	String

• Success Response:
  • Code: 200
    
  • Response Body:

{
    "status": 200,
    "message": "지원한 이벤트 조회 성공",
    "data": [
        {
            "id": 44,
            "appliedAt": "2023-03-17T16:12:35.641441",
            "imgUrl": "https://www.culture.go.kr/upload/rdf/22/07/show_2022071814552019267.jpg",
            "title": "댄스 공연 의상 같이 살 분 구해요",
            "profile": {
                "name": "랄랄"
            },
            "matched": false
        },
        {
            "id": 43,
            "appliedAt": "2023-03-17T16:12:30.169157",
            "imgUrl": "https://www.culture.go.kr/upload/rdf/22/07/show_2022071814552019267.jpg",
            "title": "기초 댄스 수업 재능 나눔",
            "profile": {
                "name": "랄랄"
            },
            "matched": false
        }
    ]
}          

📚 멤버 관련 API

구글 연동 로그인을 통한 회원가입

• URL

  /api/v1/member/oauth/google/login

• Method

  GET

• Header Parameter

Parameter	Description	Required or Optional	Default Value	Type
google-token	구글 서비스로부터 발급받은 Token	Required	X	String

• Success Response:
  • Code: 200
    
  • Response Body:

{
  "data": {
    "email": "string",
    "id": 0,
    "imgUrl": "string",
    "name": "string",
    "profile": {
      "careerStartDate": "2023-03-17",
      "description": "string",
      "genres": [
        "string"
      ],
      "id": 0,
      "imgUrl": "string",
      "location": "string",
      "name": "string",
      "openChatUrl": "string",
      "portfolio": {
        "instagram": "string",
        "tiktok": "string",
        "youtube": "string"
      },
      "type": "string"
    },
    "role": "string",
    "signUp": true
  },
  "message": "string",
  "status": 0
}       

본인 정보 조회

• URL

  /api/v1/member/info

• Method

  GET

• Header Parameter

Parameter	Description	Required or Optional	Default Value	Type
authorization	서버에서 발급한 access Token	Required	X	String

• Success Response:
  • Code: 200
    
  • Response Body:

{
  "data": {
    "email": "string",
    "id": 0,
    "imgUrl": "string",
    "name": "string",
    "profile": {
      "careerStartDate": "2023-03-17",
      "description": "string",
      "genres": [
        "string"
      ],
      "id": 0,
      "imgUrl": "string",
      "location": "string",
      "name": "string",
      "openChatUrl": "string",
      "portfolio": {
        "instagram": "string",
        "tiktok": "string",
        "youtube": "string"
      },
      "type": "string"
    },
    "role": "string",
    "signUp": true
  },
  "message": "string",
  "status": 0
}        

회원 탈퇴

• URL

  /api/v1/member

• Method

  DELETE

• Header Parameter

Parameter	Description	Required or Optional	Default Value	Type
authorization	서버에서 발급한 access Token	Required	X	String

• Success Response:
  • Code: 200
    
  • Response Body:

{
  "message": "string",
  "status": 0
}       

로그아웃

• URL

  /api/v1/member/logout

• Method

  GET

• Header Parameter

Parameter	Description	Required or Optional	Default Value	Type
authorization	서버에서 발급한 access Token	Required	X	String

• Success Response:
  • Code: 200
    
  • Response Body:

{
  "message": "string",
  "status": 0
}       

📚 JWT 토큰 재발급 API

JWT 토큰 재발급

• URL

  /api/v1/oauth/jwt/refresh

• Method

  GET

• Header Parameter

Parameter	Description	Required or Optional	Default Value	Type
refreshToken	refresh token 을 cookie 에 'refreshToken' key 로 갖는 value 로 받는다.	Required	X	String

• Success Response:
  • Code: 200
    
  • Response Body:

{
  "message": "string",
  "status": 0
}       

📚 S3 관련 API

이벤트 이미지 등록

• URL

  /api/v1/events/image

• Method

  POST

• Header Parameter

Parameter	Description	Required or Optional	Default Value	Type
authorization	서버에서 발급한 access Token	Required	X	String

• Form Data(File)

Parameter	Description	Required or Optional	Default Value	Type
img	jpg, jpeg, png 형식의 파일만 업로드할 수 있습니다.	Required	X	String

• Success Response:
  • Code: 200
    
  • Response Body:

{
  "data": {
    "imgUrl": "string"
  },
  "message": "string",
  "status": 0
}      

공연 이미지 등록

• URL

  /api/v1/performances/image

• Method

  POST

• Header Parameter

Parameter	Description	Required or Optional	Default Value	Type
authorization	서버에서 발급한 access Token	Required	X	String

• Form Data(File)

Parameter	Description	Required or Optional	Default Value	Type
img	jpg, jpeg, png 형식의 파일만 업로드할 수 있습니다.	Required	X	String

• Success Response:
  • Code: 200
    
  • Response Body:

{
  "data": {
    "imgUrl": "string"
  },
  "message": "string",
  "status": 0
}      

프로필 이미지 등록

• URL

  /api/v1/profiles/image

• Method

  POST

• Header Parameter

Parameter	Description	Required or Optional	Default Value	Type
authorization	서버에서 발급한 access Token	Required	X	String

• Form Data(File)

Parameter	Description	Required or Optional	Default Value	Type
img	jpg, jpeg, png 형식의 파일만 업로드할 수 있습니다.	Required	X	String

• Success Response:
  • Code: 200
    
  • Response Body:

{
  "data": {
    "imgUrl": "string"
  },
  "message": "string",
  "status": 0
}