setting: envelope json 규격 및 에러 코드/핸들링 추가

[ohksj77]

수정 이유

• 클라이언트와의 통신 시 공통 응답 규격을 두고자 작업했습니다.
• [SETTING] API 공통 규격 설정 #3

추가/수정한 기능

공통 응답 & 에러 규격

• 공통 응답 규격 추가: ApiResponse, 에러 규격 추가: ErrorDetail
  • 이 둘을 생성하기 위한 팩토리 메서드 추가
• 비즈니스 최상위 예외 추가, 에러 코드 명세를 위한 enum 추가
• 전역 에러 핸들링 Advice 추가
• 응답 Body Advice 추가 (ApiResponse 래핑을 위함)

Etc

• Url Path 기반 버저닝에서 헤더 기반 버저닝으로 이전 (Swagger 충돌 이슈로 인함)
• 인프라 설정의 헬스 체크 Url 내의 버전 path 제거

특이사항

• 아래는 API 규격 예시입니다:

• 성공

• 실패

check list

• 모든 단위 테스트를 돌려보고 기존에 작동하던 테스트에 영향이 없는 것을 확인했나요?
• 추가/수정사항을 설명했나요?

[JihwanByun]

Url Path 기반 버저닝에서 헤더 기반 버저닝으로 이전 (Swagger 충돌 이슈로 인함)
이부분 더 자세히 설명해주실 수 있을까요?

[ohksj77]

Url Path 기반 버저닝에서 헤더 기반 버저닝으로 이전 (Swagger 충돌 이슈로 인함)
이부분 더 자세히 설명해주실 수 있을까요?

swagger가 자동으로 만들어주는 url 중에 /v3/api-docs 라는 path 가 있는데, 저희가 기존에 활용하고자 했던 api/v1 과 충돌이 발생하여 swagger가 접근이 안되는 이슈가 발생했었습니다. 이에 헤더에 버전을 넣도록 수정하였습니다.