인증 방식

API 접근을 위한 인증은 JWT(JSON Web Token) 를 사용하여 인증합니다. / , /api/v1/users/login , /api/v1/users/signup 을 제외한 모든 요청은 Access-Token: Bearer {JWT} 형식으로 JWT 토큰을 헤더에 포함해야 합니다.

공통 응답(Response) 형식

API 응답은 JSON 형식으로 반환되며, 다음과 같은 필드를 포함합니다.

• message : 요청의 처리 결과에 대한 메시지입니다.
• data : 요청이 성공했을 때 반환되는 실제 데이터입니다.

응답 예시

{
  "message": "SUCCESS",
  "data": {
    "id": "da342734-a3d0-4779-887b-a2d1ac385b3c",
    "name": "10,000원 할인 쿠폰",
    "discountPrice": 10000,
    "expiration": "2025-02-28T23:59:59"
  }
}

전역 예외 처리 형식

응답 구조

• message : 요청의 처리 결과에 대한 에러 메시지입니다.
• data : 에러 발생의 구체적인 이유나 코드입니다. (예: DUPLICATE_USERNAME)