Xsolla-logo
  • 文档
  • 创建帐户

获取验证码Client-side

get/otc/code

等待直到用户点击通过电子邮件或短信提供的链接并返回用于认证的验证码。如果发送了此调用,但20秒后仍未收到代码,则说明发生了错误。该情况下,请立即重新发送调用。代码有效期为3分钟。

此调用的使用流程:

  1. 应用程序打开一个认证表单,以便用户输入其邮箱地址。
  2. 用户输入其邮箱地址。
  3. 应用程序将通过邮箱或手机号码开始认证(JWT或OAuth 2.0)请求发送给艾克索拉登录管理器服务器: a. 如果参数send_linktrue,则在此请求之后应发送同样的请求使电子邮件或短信包含验证码和链接。 b. 如果参数send_linkfalse或未通过,则电子邮件将仅包含验证码。
  4. 艾克索拉登录管理器服务器向用户发送电子邮件或短信,并返回验证码的ID。
  5. 应用程序向用户显示一个字段以便填写验证码。
  6. 用户输入收到的验证码或点击链接。
  7. 应用程序将通过邮箱或手机号码完成认证(JWT 或 OAuth 2.0)请求以及收到的ID发送给艾克索拉登录管理器服务器。
  8. 用户被视为已授权。
Request
query Parameters
projectId
required
string <uuid>

发布商帐户中的登录管理器项目ID。

login
required
string

用户的登录标识符。可以是邮箱地址或手机号码。

operation_id
required
string

验证码ID。可在先前请求的响应中找到其值。

Responses
200

确定

408

超过最后期限

429

请求过多

Request samples
curl --request GET \
  --url 'https://login.xsolla.com/api/otc/code?projectId=SOME_STRING_VALUE&login=SOME_STRING_VALUE&operation_id=SOME_STRING_VALUE'
Response samples
application/json
{
  • "code": "string"
}