Login 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.用户应尝试使用其他可接收短信的手机号码。
    002-050User MFA settings have not changed.当尝试启用已启用的双重认证或禁用已禁用的双重认证时,会出现此错误。
    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.请确保存在提供的client 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年8月29日

    发现了错别字或其他内容错误? 请选择文本,然后按Ctrl+Enter。

    报告问题
    我们非常重视内容质量。您的反馈将帮助我们做得更好。
    请留下邮箱以便我们后续跟进
    感谢您的反馈!
    无法发送您的反馈
    请稍后重试或发送邮件至doc_feedback@xsolla.com与我们联系。