HTTP 상태코드

상태코드 설명 비고
200 성공 요청이 성공적으로 처리됨을 의미하며, API별로 정상 처리 결과는 응답바디를 참조
400 (Bad Request) 잘못된 요청 요청 구문이나, 메시지 파라미터 등 필수 파라미터와 관련한 오류
401 (Unauthorized) 인증 실패 인증 자격 증명에 관련한 오류
403 (Forbidden) 접근 금지 자원에 대한 접근이 권한/퍼미션으로 인해 금지되었을 때 발생하는 오류
404 (Not Found) 찾을 수 없음 요청한 리소스를 찾을 수 없을 때 발생하는 오류
500 (Internal Server Error) 서버 내부 오류 서버에 오류가 발생하여 요청을 수행할 수 없을 때의 시스템 오류

Error Type

필드명 타입 설명
status int HTTP 상태 코드
code int 에러 코드
message Map<String, String> 에러 메시지를 담고 있는 맵, 키는 에러 관련 필드 명, 값은 에러 설명

Error Code

Error Code code Name 설명 HTTP 상태 코드
1001 VALIDATION_FAILED 요청에 대한 유효성 검증 실패 400
1002 WRONG_REQUEST_TRANSMISSION 잘못된 요청의 전달 400
1003 MISSING_PART 필수적인 요소의 누락 400
1004 DUPLICATE_RESOURCE 중복된 리소스의 전달 400
1101 ROLE_BASED_ACCESS_ERROR 역할 기반 접근 제어 오류 403
1102 RESOURCE_ACCESS_FORBIDDEN 리소스 접근 권한 오류 403
1201 AUTHENTICATION_FAILED 인증 실패 401
1202 ACCESS_DENIED 리소스 접근에 대한 권한 부족 401
1301 RESOURCE_NOT_FOUND 존재하지 않는 리소스 접근 시도 404
2000 INTERNAL_SERVER_ERROR 서버 내부 오류 500

✔ 응답 본문의 예시

{
    "success": false,
    "response": null,
    "error": {
        "status": "400",
        "code": "1001",
        "message": {
            "password": "Password must be between 8 and 20 characters."
        }
    }
}