API
/
Error codes
Error codes
Review the possible errors that may occur when using the project API.
Last updated: 2025.05.27
Errors by Category
Authentication-related error
Status code
Error code
Error message
403
AUTH_INVALID_CREDENTIALS
You can create up to 100 files per order request.
429
AUTH_TOO_MANY_ATTEMPTS
Too many login attempts. Please try again later.
403
AUTH_ACCOUNT_INACTIVE
This account has been deactivated. Please contact the administrator.
401
AUTH_TOKEN_EXPIRED
The authentication token has expired.
401
AUTH_TOKEN_INVALID
The authentication token is invalid.
401
AUTH_TOKEN_INVALID_FORMAT
The token format is invalid.
400
AUTH_PASSWORD_RESET_EXPIRED
The password reset link has expired.
401
AUTH_REFRESH_TOKEN_INVALID
The refresh token is invalid.
401
AUTH_REFRESH_TOKEN_EXPIRED
The refresh token has expired. Please log in again.
401
AUTH_NOT_AUTHENTICATED
Authentication is required.
User-related error
Status code
Error code
Error message
409
USER_ALREADY_EXISTS
This email is already registered.
404
USER_NOT_FOUND
No user found with this email address.
500
USER_CREATION_FAILED
An error occurred while creating the user.
500
USER_UPDATE_FAILED
An error occurred while updating user information.
Email-related error
Status code
Error code
Error message
400
EMAIL_VERIFICATION_INVALID
The verification code is invalid.
400
EMAIL_VERIFICATION_EXPIRED
The verification code has expired.
500
EMAIL_SENDING_FAILED
An error occurred while sending the email.
400
EMAIL_TYPE_INVALID
Unsupported email type.
400
EMAIL_ALREADY_EXISTS
This email is already in use.
Server-related error
Status code
Error code
Error message
500
SERVER_DATABASE_ERROR
A database error has occurred.
500
SERVER_INTERNAL_ERROR
An internal server error has occurred.
Validation-related error
Status code
Error code
Error message
400
VALIDATION_FAILED
The input value is invalid.
400
VALIDATION_IDEMPOTENCY_KEY_INVALID
Idempotency key validation failed.
400
VALIDATION_EMAIL_INVALID
Please enter a valid email address.
400
VALIDATION_PASSWORD_INVALID
Passwords must be at least 8 characters long and include uppercase and lowercase letters, numbers, and special characters.
Inquiry-related error
Status code
Error code
Error message
500
CONTACT_SUBMISSION_FAILED
문의 제출 중 오류가 발생했습니다.
400
CONTACT_INVALID_DATA
유효하지 않은 문의 데이터입니다.
Plan-related error
Status code
Error code
Error message
404
PLAN_NOT_FOUND
Plan information could not be found.
400
USAGE_LIMIT_EXCEEDED
You have exceeded the usage limit.
500
USAGE_UPDATE_FAILED
Failed to increase usage.
500
USAGE_DECREASE_FAILED
Failed to decrease usage.
S3-related error
Status code
Error code
Error message
500
S3_PRESIGNED_URL_GENERATION_FAILED
An error occurred while generating the S3 presigned URL.
500
S3_FILE_NOT_FOUND
The file could not be found on S3.
500
S3_SERVICE_ERROR
An error occurred with the S3 service.
500
S3_UPLOAD_ERROR
An error occurred while uploading the file to S3.
500
S3_DELETE_ERROR
An error occurred while deleting the file from S3.
Image protection-related error
Status code
Error code
Error message
500
IMAGE_PROTECTION_FAILED
An error occurred during image protection processing.
Order-related error
Status code
Error code
Error message
404
ORDER_NOT_FOUND
The order could not be found.
400
ORDER_NOT_PENDING
The order is not in a pending state.
403
ORDER_NOT_OWNER
You are not the owner of this order.
400
ORDER_EXPIRED
The order has expired.
400
ORDER_NOT_PROCESSING
The order is not being processed.
404
ORDER_FILE_NOT_FOUND
The order file could not be found.
400
ORDER_NOT_COMPLETED
The order has not been completed.
400
ORDER_FILE_NOT_UPLOADED
The order file has not been uploaded.
400
ORDER_ALREADY_CONFIRMED
The order has already been confirmed.
400
ORDER_FILES_NOT_COMPLETED
Not all files in the order have been processed.
400
ORDER_PROCESSED_FILES_MISSING
No processed files are available.
Webhook-related error
Status code
Error code
Error message
404
WEBHOOK_SECRET_NOT_FOUND
The webhook secret could not be found. Please contact the administrator.
Error code format
Error codes follow the following format:
{CATEGORY}_{DETAIL}
List of categories
AUTH: Authentication-related
USER: User-related
EMAIL: Email-related
SERVER: Server-related
VALIDATION: Validation-related
CONTACT: Inquiry-related
PLAN: Plan-related
S3: S3-related
IMAGE: Image processing-related
ORDER: Order-related
WEBHOOK: Webhook-related
Getting Started
Integration Guide
시작하기
/
이용 안내
오류코드
프로젝트 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: 웹훅 관련