API
/
Error codes
Error codes
Review the errors that may occur when using the project API.
Last Updated: 2025.05.27
Errors by Category
Authentication-Related Errors
Status Code
Error Code
Error message
403
AUTH_INVALID_CREDENTIALS
You can generate up to 100 files per order request.
429
AUTH_TOO_MANY_ATTEMPTS
Too many login attempts, please try again in a moment.
403
AUTH_ACCOUNT_INACTIVE
Invalid account, please contact your administrator.
401
AUTH_TOKEN_EXPIRED
The authentication token has expired.
401
AUTH_TOKEN_INVALID
Invalid authentication token.
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
Invalid refresh token.
401
AUTH_REFRESH_TOKEN_EXPIRED
Your refresh token has expired. Please log in again.
401
AUTH_NOT_AUTHENTICATED
Authentication is required.
User-Related Errors
Status Code
Error Code
Error message
409
USER_ALREADY_EXISTS
이미 가입된 이메일입니다.
404
USER_NOT_FOUND
해당 이메일로 등록된 사용자가 없습니다.
500
USER_CREATION_FAILED
사용자 생성 중 오류가 발생했습니다.
500
USER_UPDATE_FAILED
사용자 정보 업데이트 중 오류가 발생했습니다.
Email-Related Errors
Status Code
Error Code
Error message
400
EMAIL_VERIFICATION_INVALID
Invalid authentication code.
400
EMAIL_VERIFICATION_EXPIRED
Expired authentication code.
500
EMAIL_SENDING_FAILED
An error occurred while sending an email.
400
EMAIL_TYPE_INVALID
This is an email type that is not supported.
400
EMAIL_ALREADY_EXISTS
This email is already in use.
Server-Related Errors
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 Errors
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
The password must be at least 8 characters long and include uppercase letters, lowercase letters, numbers, and special characters.
Support-Related Errors
Status Code
Error Code
Error message
500
CONTACT_SUBMISSION_FAILED
An error occurred while submitting your inquiry.
400
CONTACT_INVALID_DATA
Invalid inquiry data.
Plan-Related Errors
Status Code
Error Code
Error message
404
PLAN_NOT_FOUND
Plan information not 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 in S3.
500
S3_SERVICE_ERROR
An S3 service-related error has occurred.
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 Processing 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
Order not found.
400
ORDER_NOT_PENDING
The order is not in a pending state.
403
ORDER_NOT_OWNER
You are not the owner of the order.
400
ORDER_EXPIRED
The order has expired.
400
ORDER_NOT_PROCESSING
The order is not in processing.
404
ORDER_FILE_NOT_FOUND
Order file not 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
There are no processed files.
Webhook-related Error
Status Code
Error Code
Error message
404
WEBHOOK_SECRET_NOT_FOUND
Webhook secret not found. Please contact the administrator.
Error Code Format
Error codes follow the format below:
{category}_{detail}
Category List
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
On this page
API
/
Error codes
Error codes
Review the errors that may occur when using the project API.
Last Updated: 2025.05.27
Errors by Category
Authentication-Related Errors
Status Code
Error Code
Error message
403
AUTH_INVALID_CREDENTIALS
You can generate up to 100 files per order request.
429
AUTH_TOO_MANY_ATTEMPTS
Too many login attempts, please try again in a moment.
403
AUTH_ACCOUNT_INACTIVE
Invalid account, please contact your administrator.
401
AUTH_TOKEN_EXPIRED
The authentication token has expired.
401
AUTH_TOKEN_INVALID
Invalid authentication token.
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
Invalid refresh token.
401
AUTH_REFRESH_TOKEN_EXPIRED
Your refresh token has expired. Please log in again.
401
AUTH_NOT_AUTHENTICATED
Authentication is required.
User-Related Errors
Status Code
Error Code
Error message
409
USER_ALREADY_EXISTS
이미 가입된 이메일입니다.
404
USER_NOT_FOUND
해당 이메일로 등록된 사용자가 없습니다.
500
USER_CREATION_FAILED
사용자 생성 중 오류가 발생했습니다.
500
USER_UPDATE_FAILED
사용자 정보 업데이트 중 오류가 발생했습니다.
Email-Related Errors
Status Code
Error Code
Error message
400
EMAIL_VERIFICATION_INVALID
Invalid authentication code.
400
EMAIL_VERIFICATION_EXPIRED
Expired authentication code.
500
EMAIL_SENDING_FAILED
An error occurred while sending an email.
400
EMAIL_TYPE_INVALID
This is an email type that is not supported.
400
EMAIL_ALREADY_EXISTS
This email is already in use.
Server-Related Errors
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 Errors
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
The password must be at least 8 characters long and include uppercase letters, lowercase letters, numbers, and special characters.
Support-Related Errors
Status Code
Error Code
Error message
500
CONTACT_SUBMISSION_FAILED
An error occurred while submitting your inquiry.
400
CONTACT_INVALID_DATA
Invalid inquiry data.
Plan-Related Errors
Status Code
Error Code
Error message
404
PLAN_NOT_FOUND
Plan information not 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 in S3.
500
S3_SERVICE_ERROR
An S3 service-related error has occurred.
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 Processing 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
Order not found.
400
ORDER_NOT_PENDING
The order is not in a pending state.
403
ORDER_NOT_OWNER
You are not the owner of the order.
400
ORDER_EXPIRED
The order has expired.
400
ORDER_NOT_PROCESSING
The order is not in processing.
404
ORDER_FILE_NOT_FOUND
Order file not 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
There are no processed files.
Webhook-related Error
Status Code
Error Code
Error message
404
WEBHOOK_SECRET_NOT_FOUND
Webhook secret not found. Please contact the administrator.
Error Code Format
Error codes follow the format below:
{category}_{detail}
Category List
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
Integration Guide