Xsolla-logo

静默认证

get/social/{cross_social_provider_name}/cross_auth

将来自Steam、Xbox或Epic Games的用户JWT交换为您项目中的JWT (projectId)。

您将获得将用户重定向到您项目的链接。

要启用静默认证,请参阅说明

Request
path Parameters
cross_social_provider_name
required
string

用户授权进入的平台名称。可以是steamxboxepicgames

query Parameters
projectId
required
string <uuid>

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

login_url
string

在帐户确认、成功认证、双因素认证配置或密码重置确认后将用户重定向到的URL。必须与发布商帐户URL部分中指定的回调URL相同。要找到它,请前往登录管理器 > 您的登录管理器项目,在导航页的顶部区块中选择回调部分。 如果有多个回调URL,此参数为必需

fields
Array of strings non-empty

必须额外从用户或社交网络请求并写入JWT的参数列表。参数必须用逗号分隔。例如,email

如果请求了email而社交网络没有响应email值:

  • 将提示用户在相应的表单中输入邮箱地址(如果集成了登录管理器小组件);
  • 必须要求用户在您自己的界面中输入邮箱地址(如果集成了Login API)。请将该表单的URL发送给您的帐户经理。

输入邮箱地址后,用户会收到一封邮箱确认消息。要禁用邮箱确认,请联系您的帐户经理。

app_id
string

您在平台中的应用ID。

payload
string

您的自定义数据。参数的值将在用户JWTpayload声明中返回。

with_logout
string
Default: "0"

显示是否停用现有用户JWT值并激活此调用生成的值。可以是以下值:

  • 1,停用现有值并激活新值;
  • 0,保持现有值的激活状态。
session_ticket
string

从平台收到的会话票证。

code
string

从平台收到的代码。

is_redirect
boolean
Default: true

显示艾克索拉登录管理器服务器应如何响应。如果设置:

  • true值,艾克索拉登录管理器服务器将返回302响应代码。包含用户JWT以用于用户重定向的URL在Location标头中。
  • false值,艾克索拉登录管理器服务器返回200响应代码。包含用户JWT以用于用户重定向的URL在响应正文中。
Responses
200

确定

302

重定向

400

错误的请求

404

未找到

422

无法处理的实体

429

请求过多

Request samples
Response samples
application/json
{
  • "login_url": "string"
}