通过邮箱开始认证

通过邮箱开始认证Client-side

post/oauth2/login/email/request

通过用户邮箱地址和验证码开始认证并将验证码发送至其邮箱地址。验证码有效期为3分钟。

此调用仅可与通过邮箱完成认证调用一起使用。

使用此调用的工作流如下：

应用程序打开一个认证表单，以便用户可以输入其邮箱地址。
用户输入其邮箱地址。
应用程序将此请求发送给艾克索拉登录管理器服务器： a. 如果参数send_link为true，则在此请求之后，您应该发送获取验证码请求，使邮件包含验证码和链接。 b. 如果参数send_link为false或未传入，则邮件将仅包含验证码。
艾克索拉登录管理器服务器发送邮件并返回验证码的ID。
应用程序显示一个字段，以便用户可以填写验证码。
用户输入收到的验证码或点击链接。
应用程序将通过邮箱完成认证请求连同收到的ID发送给艾克索拉登录管理器服务器。
用户被视为已授权。

Request

response_type required	string 启用了OAuth 2.0协议项目中使用的授权类型。必须是`code`才能在响应中获取用户认证代码。必须通过生成JWT调用将收到的代码交换给JWT以完成用户认证。
client_id required	integer 您的应用程序ID。在创建OAuth 2.0客户端后获取。
state required	string 用于额外用户验证的值。通常用于抵御CSRF攻击。该值将在响应中返回。必须长于8个符号。
scope	string 范围是OAuth 2.0中的一种机制，用于限制应用程序对用户帐户的访问。可以是： `offline`，使用来自生成JWT调用的`refresh_token`以在JWT过期时刷新。 `playfab`，将SessionTicket写入JWT的`session_ticket`声明（如果您在PlayFab中存储用户数据）。如果您处理上面未提及的自己的`scope`参数值，则可以在使用此调用时设置它们。艾克索拉登录管理器服务器不处理这些值，而是在收到的JWT中返回它们。
redirect_uri	string 在帐户确认、成功认证或密码重置确认后将用户重定向到的URL。要设置此参数，请联系您的客户成功经理或发送邮件至csm@xsolla.com。注：如果项目设置中有多个重定向URI，则该参数为必需。

email required	string [ 1 .. 255 ] characters 用户邮箱地址。
link_url	string <uri> 将用户重定向到状态认证页面的URL。如果参数`send_link`为`true`，则为必需。
send_link	boolean 显示发送的验证码邮件中是否包含链接。可以使用链接代替验证码登录。如果参数值为`true`，则链接包含在邮件中发送。

Responses

200

确定

400

错误的请求

404

未找到

422

无法处理的实体

429

请求过多

Request samples

application/json

{"email": "string",
"link_url": "http://example.com",
"send_link": true
}

Response samples

application/json

{"operation_id": "string"
}