최종수정일: 2025. 05. 27

API 에러 코드

프로젝트 API를 사용할 때 발생할 수 있는 에러를 살펴보세요.

카테고리별 에러

인증 관련 에러

상태 코드	에러 코드	에러 메시지
403	AUTH_INVALID_CREDENTIALS	이메일 또는 비밀번호가 올바르지 않습니다.
429	AUTH_TOO_MANY_ATTEMPTS	로그인 시도가 너무 많습니다. 잠시 후 다시 시도해주세요.
403	AUTH_ACCOUNT_INACTIVE	비활성화된 계정입니다. 관리자에게 문의하세요.
401	AUTH_TOKEN_EXPIRED	인증 토큰이 만료되었습니다.
401	AUTH_TOKEN_INVALID	유효하지 않은 인증 토큰입니다.
401	AUTH_TOKEN_INVALID_FORMAT	토큰 형식이 유효하지 않습니다.
400	AUTH_PASSWORD_RESET_EXPIRED	비밀번호 재설정 링크가 만료되었습니다.
401	AUTH_REFRESH_TOKEN_INVALID	유효하지 않은 리프레시 토큰입니다.
401	AUTH_REFRESH_TOKEN_EXPIRED	리프레시 토큰이 만료되었습니다. 다시 로그인해주세요.
401	AUTH_NOT_AUTHENTICATED	인증이 필요합니다.

사용자 관련 에러

상태 코드	에러 코드	에러 메시지
409	USER_ALREADY_EXISTS	이미 가입된 이메일입니다.
404	USER_NOT_FOUND	해당 이메일로 등록된 사용자가 없습니다.
500	USER_CREATION_FAILED	사용자 생성 중 오류가 발생했습니다.
500	USER_UPDATE_FAILED	사용자 정보 업데이트 중 오류가 발생했습니다.

이메일 관련 에러

상태 코드	에러 코드	에러 메시지
400	EMAIL_VERIFICATION_INVALID	유효하지 않은 인증 코드입니다.
400	EMAIL_VERIFICATION_EXPIRED	만료된 인증 코드입니다.
500	EMAIL_SENDING_FAILED	이메일 전송 중 오류가 발생했습니다.
400	EMAIL_TYPE_INVALID	지원하지 않는 이메일 타입입니다.
400	EMAIL_ALREADY_EXISTS	이미 사용 중인 이메일입니다.

서버 관련 에러

상태 코드	에러 코드	에러 메시지
500	SERVER_DATABASE_ERROR	데이터베이스 오류가 발생했습니다.
500	SERVER_INTERNAL_ERROR	서버 내부 오류가 발생했습니다.

유효성 검사 관련 에러

상태 코드	에러 코드	에러 메시지
400	VALIDATION_FAILED	입력값이 유효하지 않습니다.
400	VALIDATION_IDEMPOTENCY_KEY_INVALID	멱등성 키 유효성 검사 실패
400	VALIDATION_EMAIL_INVALID	유효한 이메일 주소를 입력해주세요.
400	VALIDATION_PASSWORD_INVALID	비밀번호는 최소 8자 이상이며, 영문 대/소문자, 숫자, 특수문자를 포함해야 합니다.

문의하기 관련 에러

상태 코드	에러 코드	에러 메시지
500	CONTACT_SUBMISSION_FAILED	문의 제출 중 오류가 발생했습니다.
400	CONTACT_INVALID_DATA	유효하지 않은 문의 데이터입니다.

플랜 관련 에러

상태 코드	에러 코드	에러 메시지
404	PLAN_NOT_FOUND	플랜 정보를 찾을 수 없습니다.
400	USAGE_LIMIT_EXCEEDED	사용량 제한을 초과했습니다.
500	USAGE_UPDATE_FAILED	사용량 증가에 실패했습니다.
500	USAGE_DECREASE_FAILED	사용량 감소에 실패했습니다.

S3 관련 에러

상태 코드	에러 코드	에러 메시지
500	S3_PRESIGNED_URL_GENERATION_FAILED	S3 프리사인드 URL 생성 중 오류가 발생했습니다.
500	S3_FILE_NOT_FOUND	S3에서 파일을 찾을 수 없습니다.
500	S3_SERVICE_ERROR	S3 서비스 관련 오류가 발생했습니다.
500	S3_UPLOAD_ERROR	S3 파일 업로드 중 오류가 발생했습니다.
500	S3_DELETE_ERROR	S3 파일 삭제 중 오류가 발생했습니다.