로그인 API 오류

오류 응답이 있는 경우 엑솔라 로그인 서버는 다음 필드가 있는 JSON 개체를 반환합니다.

필드유형설명
code               string       엑솔라 로그인 서버 오류 코드입니다.
descriptionstring오류 설명입니다. 텍스트는 항상 영어로 되어 있습니다. 오류가 발생할 경우 나중에 값이 변경될 수 있으므로 이 텍스트를 사용해선 안 됩니다.
예시:
Copy
Full screen
Small screen
    1{
    2  "error": {
    3    "code": "000-000",
    4    "description": "description"
    5  }
    6}
    
    코드설명문제 해결
    002-016Invalid JWT.다시 로그인을 시도해야 합니다.
    002-027Parameter is invalid.모든 요청 매개 변수가 올바른지 확인하세요.
    002-028Parameter was not passed.모든 필수 매개 변수를 제공했는지 확인하세요.
    002-040This user is banned.게임 지원팀에 문의해야 합니다.
    002-043This phone number cannot receive SMS. Use a different number.SMS를 수신할 수 있는 다른 전화번호를 사용해야 합니다.
    002-050User MFA settings have not changed.2단계 인증이 이미 활성화되어 있는 경우 활성화하려고 하거나 이미 비활성화된 경우 비활성화하려고 할 때 오류가 발생합니다.
    002-056Invalid phone number. Verify the number or try another one.전화번호를 인증하거나 다른 전화번호를 입력해야 합니다.
    002-057Too many login attempts.나중에 다시 시도해야 합니다. 이 오류가 발생하지 않아야 한다고 생각되면 메신저를 통해 연동 서비스 팀에 문의하세요.
    002-058You exceeded login attempts limit. To unblock your account, follow the link in the email that we sent or reset your password.이메일에 포함된 링크를 사용하여 계정 차단을 해제하거나 암호를 재설정해야 합니다.
    002-060User younger than required age.사용자에게 연령 제한에 대해 알립니다.
    003-001Incorrect email address/username or password.입력한 정보를 확인하고 다시 시도해야 합니다.
    003-002User is not signed up.계속하려면 게임에 가입해야 합니다.
    003-003User with this username already exists. Try another username.다른 사용자 이름을 사용해야 합니다.
    003-004User with this email address already exists. Try another email address.다른 이메일 주소를 사용해야 합니다.
    003-005Email address does not exist. Try another email address.다른 이메일 주소를 시도해야 합니다.
    003-007Account not activated. Please confirm email address.계정을 활성화하려면 이메일 주소를 확인해야 합니다. 확인 이메일을 받지 못했다면 스팸 폴더를 확인해야 합니다.
    003-008Changing email address not allowed.이메일 주소를 변경할 수 없습니다.
    003-009User search request wrong.기술적인 이유로 검색에 실패했습니다. 나중에 다시 시도하세요.
    003-010Changing birth date is unavailable.생년월일을 변경할 수 없습니다.
    003-011Email address not confirmed. Try another email address or confirm this one.이메일 주소를 확인하거나 등록 시 이전에 사용하지 않은 다른 이메일 주소를 사용해야 합니다.
    003-012User with specified phone number already exists.등록 시 전화번호를 확인하거나 이전에 사용하지 않은 다른 전화번호를 사용해야 합니다.
    003-019Login with this project ID not found.전달된 ID가 있는 인증 변형이 존재하는지 확인합니다.
    003-020Call unavailable for this Login project.관리자 페이지에서 인증 옵션 설정을 확인합니다.
    003-021Logging in via username/password not allowed.게임 지원팀에 문의해야 합니다.
    003-022Incorrect project configuration.관리자 페이지에서 인증 옵션 설정을 확인합니다.
    003-023Signing up via username/password not allowed.이 인증 옵션의 경우 등록이 허용되지 않습니다. 게임 지원팀에 문의해야 합니다.
    003-030Link has expired. Please perform password recovery again.암호 재설정 링크가 만료되었거나 올바르지 않습니다. 암호 재설정을 다시 시도해야 합니다.
    003-049Too many attempts to use confirmation code. Try again later.나중에 다시 시도해야 합니다.
    007-001Login via phone is currently unavailable in your country. Please try a different login method.대체 로그인 방법을 사용해야 합니다.
    008-001Passwordless login URL not configured.관리자 페이지(사용자 데이터베이스 > 저장소 > 사용자 지정 저장소 섹션)의 인증 옵션 설정에 올바른 로그인 URL을 추가합니다.
    008-002User verification URL not configured.관리자 페이지(사용자 데이터베이스 > 저장소 > 사용자 지정 저장소 섹션)의 인증 옵션 설정에 올바른 사용자 인증 URL을 추가합니다.
    008-003New user URL not configured.관리자 페이지(사용자 데이터베이스 > 저장소 > 사용자 지정 저장소 섹션)의 인증 옵션 설정에 올바른 로그인 URL을 추가합니다.
    008-004Password reset URL not configured.관리자 페이지(사용자 데이터베이스 > 저장소 > 사용자 지정 저장소 섹션)의 인증 옵션 설정에 올바른 암호 재설정URL을 추가합니다.
    008-005PlayFab Title ID invalid.관리자 페이지(사용자 데이터베이스 > 저장소 섹션)의 인증 옵션 설정에 올바른 직책 ID가 지정되어 있는지 확인합니다.
    008-006PlayFab API key invalid.PlayFab API 키가 유효한지 확인합니다.
    008-008Invalid response from your API. It must contain user ID as “accountID” response body parameter.서버가 응답 본문에 accountID 매개 변수를 반환하는지 확인합니다.
    008-009Invalid URL in Custom storage settings.관리자 페이지(사용자 데이터베이스 > 저장소 > 사용자 지정 저장소 섹션)의 사용자 지정 저장소 인증 옵션 설정에 지정한 URL을 확인합니다.
    008-011Set new password page URL not configured.관리자 페이지(암호 설정 섹션)의 인증 옵션 설정에 암호 설정을 위한 콜백 URL이 지정되어 있는지 확인합니다.
    008-013Consent page URL not configured or invalid.관리자 페이지( 법적 조건 > 정책 및 약관 섹션)의 인증 옵션 설정에 사용자 약정에 대한 링크가 지정되어 있는지 확인합니다.
    008-014Okta integration not completed.메신저를 통해 통합 팀에 문의하세요.
    008-015SAML integration not completed.메신저를 통해 통합 팀에 문의하세요.
    008-016Firebase API key not set.관리자 페이지(법적 조건 > 정책 및 약관 섹션)의 설정에 API 키를 추가합니다.
    010-004Service temporarily unavailable. Try again later.나중에 다시 시도해야 합니다.
    010-005Allowable number of requests exceeded. Try again later.나중에 다시 시도해야 합니다.
    010-006If this social profile is unlinked, no authentication methods will be available.소셜 네트워크 연결을 해제하기 전에 다른 인증 방법을 추가해야 합니다.
    010-007Incorrect CAPTCHA input. Try again.CAPTCHA를 다시 입력해야 합니다.
    010-010Invalid confirmation code.코드를 확인하고 다시 시도해야 합니다.
    010-014Your code is expired. Return to the login page and log in again.로그인 페이지에서 다시 로그인해야 합니다.
    010-015Something went wrong during authentication with this social network. Try again later.나중에 다시 시도해야 합니다.
    010-016This social account is already linked to another user.다른 소셜 계정을 사용해야 합니다. 오류라고 생각되면 메신저를 통해 통합 팀에 문의해야 합니다.
    010-017Client authentication failed. Some request parameters are missing in request or have invalid values.전송되는 요청 매개 변수가 정확한지 확인합니다.
    010-019Client authentication failed. Client with this client_id value does not exist.제공된 클라이언트 ID를 가진 클라이언트가 존재하는지 확인합니다.
    010-020Client authentication failed. Parameter scope is invalid or malformed.제공된 scope 매개 변수가 올바른지 확인합니다. 자세한 설정 정보는 지침을 참조하세요.
    010-021Client authentication failed. Parameter response_type is invalid or malformed. You should pass value of code parameter to response_type.response_type 매개 변수의 값이 code로 설정되어 있는지 확인합니다.
    010-022Client authentication failed. Parameter state is missing or its value has less than 8 characters.state 매개 변수가 존재하고 최소 8자로 구성되어 있는지 확인합니다.
    010-023Client authentication failed. Authorization code, authorization grant types, or refresh token are invalid or expired. Also this error is returned when the redirect_uri given in authorization grant type does not match the URI provided in access token request.인증 코드가 유효하고 만료되지 않았는지, redirect_uri 매개 변수에 인증된 URL이 포함되어 있는지 확인합니다. 자세한 설정 정보는 지침을 참조하세요.
    010-026The resource owner or authorization server denied the request.리소스에 액세스할 수 있는 충분한 권한이 있는지 확인합니다.
    010-030Cross social network is not enabled for this Login.인증 옵션에 대해 교차 인증이 활성화되었는지 확인합니다. 자세한 설정 정보는 지침을 참조하세요.
    010-031Social provider already exists.이미 활성화된 소셜 네트워크에 연결하려고 시도할 때 오류가 발생했습니다.
    010-032Social network is not enabled for this Login. You can enable it in your Xsolla Publisher Account > Login Project > Social connections.관리자 페이지(소셜 네트워크를 통한 인증 섹션)의 인증 옵션 설정에 소셜 네트워크가 활성화 및 구성되어 있는지 확인합니다.
    010-033This call is temporary unavailable.나중에 다시 시도해야 합니다.
    010-035Dependency service is unavailable나중에 다시 시도해야 합니다.
    010-045Account with this social provider email address already exists.등록 시 다른 소셜 계정을 사용해야 합니다.
    030-024Password recovery is not allowed.게임 지원팀에 문의해야 합니다.
    040-001Email address must be 254 characters or shorter.254자 이내의 이메일 주소를 입력해야 합니다.
    040-002Username of the email address is invalid. Try another email address.유효한 이메일 주소를 입력해야 합니다.
    040-003Local part of the email address is too long.다른 이메일 주소를 입력해야 합니다.
    040-004Email address domain is invalid. Try another email address.엑솔라 지원팀에 문의해야 합니다.
    040-005Email address should contain one @ character only. (E.g., username@example.com)하나의 @ 문자만 포함된 이메일을 입력해야 합니다.
    040-006, 040-007, 040-008Email address domain is invalid. Try another email address.엑솔라 지원팀에 문의해야 합니다.
    040-009Email address domain doesn’t exist. Try another email address.기존 도메인이 있는 이메일을 입력해야 합니다.
    040-010Email address domain is not allowed. Try another email address.엑솔라 지원팀에 문의해야 합니다.
    010-018Email address is invalid. Try another email address.다른 이메일 주소를 입력해야 합니다.
    300-003Allowable number of requests exceeded. Try again later.나중에 다시 시도해야 합니다.
    300-005Failed to resend code. Try again later.나중에 다시 시도해야 합니다.
    300-006Incorrect confirmation code. Check the code that you received and try again.확인 코드를 확인한 후 다시 입력해야 합니다.
    300-008You’ve exceeded the maximum number of attempts. Use the new code sent to your email or phone.이메일이나 휴대폰으로 전송된 새 코드를 사용해야 합니다.
    003-007User account not confirmed.계정을 활성화하려면 이메일 주소를 확인해야 합니다. 확인 이메일을 받지 못했다면 스팸 폴더를 확인해야 합니다.
    003-025Error occurred while getting OAuth 2.0 access token.다른 인증 방법을 사용해야 합니다.
    003-040Unauthorized user.다시 로그인해야 합니다.
    003-033Mismatch project type.인증 옵션에 섀도 인증이 사용되었는지 확인합니다.
    2002-0001Duplicated attributes.생성 중인 특성이 이전에 사용자에게 추가되지 않았는지 확인합니다.
    이 기사가 도움이 되었나요?
    감사합니다!
    개선해야 할 점이 있을까요? 메시지
    유감입니다
    이 기사가 도움이 안 된 이유를 설명해 주세요. 메시지
    의견을 보내 주셔서 감사드립니다!
    메시지를 검토한 후 사용자 경험 향상에 사용하겠습니다.
    마지막 업데이트: 2025년 7월 18일

    오자 또는 기타 텍스트 오류를 찾으셨나요? 텍스트를 선택하고 컨트롤+엔터를 누르세요.

    문제 보고
    콘텐츠를 항상 검토합니다. 여러분의 피드백은 콘텐츠를 개선에 도움이 됩니다.
    후속 조치를 위해 이메일을 제공해 주세요
    의견을 보내 주셔서 감사드립니다!
    피드백을 보내는 중 문제가 발생했습니다
    잠시 후 다시 시도하거나 doc_feedback@xsolla.com으로 연락해 주세요.