11. 에러 처리

11.1 에러 응답 형식

{
  "error": {
    "code": "Bad Request.",
    "message": "Invalid request body format.",
    "details": {}
  }
}

11.2 HTTP 상태 코드

코드	의미	설명
200	OK	요청 성공
201	Created	리소스 생성 성공
204	No Content	삭제 성공 (응답 본문 없음)
400	Bad Request	잘못된 요청 (필드 누락, 유효성 검사 실패)
401	Unauthorized	인증 실패 (토큰 없음, 만료, 유효하지 않음)
403	Forbidden	권한 부족
404	Not Found	리소스 없음
409	Conflict	리소스 충돌 (중복 키 등)
500	Internal Server Error	서버 내부 오류

11.3 주요 에러 코드

에러 코드 문자열은 메시지 리소스 기반이며, locale(예: Accept-Language)에 따라 달라질 수 있다.

에러 코드	HTTP 코드	설명
Bad Request.	400	요청 형식, 파라미터, 본문 검증 오류
Unauthorized.	401	인증 실패 (잘못된/만료된 토큰, 잘못된 인증 정보)
Forbidden.	403	권한 부족
Not Found.	404	리소스를 찾을 수 없음
Conflict.	409	중복 리소스 등 충돌
Internal Server Error.	500	서버 내부 오류