API
/
오류코드
오류코드
프로젝트 API를 사용할 때 발생할 수 있는 에러를 살펴보세요.
최종 수정일: 2025.05.27
카테고리별 에러
인증 관련 에러
상태 코드
에러 코드
에러 메시지
403
AUTH_INVALID_CREDENTIALS
한 번의 주문 요청당 최대 100개의 파일을 생성할 수 있습니다.
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 파일 삭제 중 오류가 발생했습니다.
이미지 보호 처리 관련 에러
상태 코드
에러 코드
에러 메시지
500
IMAGE_PROTECTION_FAILED
이미지 보호 처리 중 오류가 발생했습니다.
주문 관련 에러
상태 코드
에러 코드
에러 메시지
404
ORDER_NOT_FOUND
주문을 찾을 수 없습니다.
400
ORDER_NOT_PENDING
주문이 대기 상태가 아닙니다.
403
ORDER_NOT_OWNER
주문 주인이 아닙니다.
400
ORDER_EXPIRED
주문이 만료되었습니다.
400
ORDER_NOT_PROCESSING
주문이 처리 중이 아닙니다.
404
ORDER_FILE_NOT_FOUND
주문 파일을 찾을 수 없습니다.
400
ORDER_NOT_COMPLETED
주문이 완료되지 않았습니다.
400
ORDER_FILE_NOT_UPLOADED
주문 파일이 업로드되지 않았습니다.
400
ORDER_ALREADY_CONFIRMED
주문이 이미 확인되었습니다.
400
ORDER_FILES_NOT_COMPLETED
주문의 모든 파일이 처리 완료되지 않았습니다.
400
ORDER_PROCESSED_FILES_MISSING
처리된 파일이 없습니다.
웹훅 관련 에러
상태 코드
에러 코드
에러 메시지
404
WEBHOOK_SECRET_NOT_FOUND
웹훅 시크릿을 찾을 수 없습니다. 관리자에게 문의하세요.
에러 코드 형식
에러 코드는 다음과 같은 형식을 따릅니다:
{카테고리}_{세부내용}
카테고리 목록
AUTH: 인증 관련
USER: 사용자 관련
EMAIL: 이메일 관련
SERVER: 서버 관련
VALIDATION: 유효성 검사 관련
CONTACT: 문의하기 관련
PLAN: 플랜 관련
S3: S3 관련
IMAGE: 이미지 처리 관련
ORDER: 주문 관련
WEBHOOK: 웹훅 관련
시작하기
/
이용 안내
오류코드
프로젝트 API를 사용할 때 발생할 수 있는 에러를 살펴보세요.
최종 수정일: 2025.05.27
카테고리별 에러
인증 관련 에러
상태 코드
에러 코드
에러 메시지
403
AUTH_INVALID_CREDENTIALS
한 번의 주문 요청당 최대 100개의 파일을 생성할 수 있습니다.
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 파일 삭제 중 오류가 발생했습니다.
이미지 보호 처리 관련 에러
상태 코드
에러 코드
에러 메시지
500
IMAGE_PROTECTION_FAILED
이미지 보호 처리 중 오류가 발생했습니다.
주문 관련 에러
상태 코드
에러 코드
에러 메시지
404
ORDER_NOT_FOUND
주문을 찾을 수 없습니다.
400
ORDER_NOT_PENDING
주문이 대기 상태가 아닙니다.
403
ORDER_NOT_OWNER
주문 주인이 아닙니다.
400
ORDER_EXPIRED
주문이 만료되었습니다.
400
ORDER_NOT_PROCESSING
주문이 처리 중이 아닙니다.
404
ORDER_FILE_NOT_FOUND
주문 파일을 찾을 수 없습니다.
400
ORDER_NOT_COMPLETED
주문이 완료되지 않았습니다.
400
ORDER_FILE_NOT_UPLOADED
주문 파일이 업로드되지 않았습니다.
400
ORDER_ALREADY_CONFIRMED
주문이 이미 확인되었습니다.
400
ORDER_FILES_NOT_COMPLETED
주문의 모든 파일이 처리 완료되지 않았습니다.
400
ORDER_PROCESSED_FILES_MISSING
처리된 파일이 없습니다.
웹훅 관련 에러
상태 코드
에러 코드
에러 메시지
404
WEBHOOK_SECRET_NOT_FOUND
웹훅 시크릿을 찾을 수 없습니다. 관리자에게 문의하세요.
에러 코드 형식
에러 코드는 다음과 같은 형식을 따릅니다:
{카테고리}_{세부내용}
카테고리 목록
AUTH: 인증 관련
USER: 사용자 관련
EMAIL: 이메일 관련
SERVER: 서버 관련
VALIDATION: 유효성 검사 관련
CONTACT: 문의하기 관련
PLAN: 플랜 관련
S3: S3 관련
IMAGE: 이미지 처리 관련
ORDER: 주문 관련
WEBHOOK: 웹훅 관련
시작하기
/
이용 안내
오류코드
프로젝트 API를 사용할 때 발생할 수 있는 에러를 살펴보세요.
최종 수정일: 2025.05.27
카테고리별 에러
인증 관련 에러
상태 코드
에러 코드
에러 메시지
403
AUTH_INVALID_CREDENTIALS
한 번의 주문 요청당 최대 100개의 파일을 생성할 수 있습니다.
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 파일 삭제 중 오류가 발생했습니다.
이미지 보호 처리 관련 에러
상태 코드
에러 코드
에러 메시지
500
IMAGE_PROTECTION_FAILED
이미지 보호 처리 중 오류가 발생했습니다.
주문 관련 에러
상태 코드
에러 코드
에러 메시지
404
ORDER_NOT_FOUND
주문을 찾을 수 없습니다.
400
ORDER_NOT_PENDING
주문이 대기 상태가 아닙니다.
403
ORDER_NOT_OWNER
주문 주인이 아닙니다.
400
ORDER_EXPIRED
주문이 만료되었습니다.
400
ORDER_NOT_PROCESSING
주문이 처리 중이 아닙니다.
404
ORDER_FILE_NOT_FOUND
주문 파일을 찾을 수 없습니다.
400
ORDER_NOT_COMPLETED
주문이 완료되지 않았습니다.
400
ORDER_FILE_NOT_UPLOADED
주문 파일이 업로드되지 않았습니다.
400
ORDER_ALREADY_CONFIRMED
주문이 이미 확인되었습니다.
400
ORDER_FILES_NOT_COMPLETED
주문의 모든 파일이 처리 완료되지 않았습니다.
400
ORDER_PROCESSED_FILES_MISSING
처리된 파일이 없습니다.
웹훅 관련 에러
상태 코드
에러 코드
에러 메시지
404
WEBHOOK_SECRET_NOT_FOUND
웹훅 시크릿을 찾을 수 없습니다. 관리자에게 문의하세요.
에러 코드 형식
에러 코드는 다음과 같은 형식을 따릅니다:
{카테고리}_{세부내용}
카테고리 목록
AUTH: 인증 관련
USER: 사용자 관련
EMAIL: 이메일 관련
SERVER: 서버 관련
VALIDATION: 유효성 검사 관련
CONTACT: 문의하기 관련
PLAN: 플랜 관련
S3: S3 관련
IMAGE: 이미지 처리 관련
ORDER: 주문 관련
WEBHOOK: 웹훅 관련