Xsolla-logo
  • 文档
  • 创建帐户

通过社交网络进行认证Client-side

get/oauth2/social/{provider_name}/login_redirect

将用户重定向到通过指定社交网络进行认证的页面。

Request
path Parameters
provider_name
required
string

Name of the social network connected to Login in Publisher Account. Can be: amazon, apple, babka, baidu, battlenet, discord, epicgames, facebook, github, google,kakao, linkedin, mailru, microsoft, msn, naver, ok, paypal, qq, reddit, steam, twitch, twitter, vimeo,vk, wechat, weibo, xbox, yahoo, yandex, youtube.

If you store user data in PlayFab, only twitch is available.

query Parameters
client_id
required
integer

您的应用程序ID。在创建OAuth 2.0客户端后获取。

state
required
string

用于额外用户验证的值。通常用于抵御CSRF攻击。该值将在响应中返回。必须长于8个符号。

response_type
required
string

启用了OAuth 2.0协议项目中使用的授权类型。必须是code才能在响应中获取用户认证代码。必须通过生成JWT调用将收到的代码交换给JWT以完成用户认证。

redirect_uri
string

在帐户确认、成功认证或密码重置确认后将用户重定向到的URL。要设置此参数,请联系您的客户成功经理或发送邮件至csm@xsolla.com

注:
如果项目设置中有多个重定向URI,则该参数为必需。
scope
string

范围是OAuth 2.0中的一种机制,用于限制应用程序对用户帐户的访问。

可以是:

如果处理上面未提及的自己的scope参数值,则可以在使用此调用时设置它们。艾克索拉登录管理器服务器不处理这些值,而是在收到的JWT中返回它们。

当请求了email而社交网络没有响应email值时:

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

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

locale
string >= 2 characters

Region in the <language code>_<country code> format, where:

The list of social networks will be sorted from most to least used, according to the variable value.

Responses
302

重定向

400

错误的请求

401

错误的请求

404

未找到

422

无法处理的实体

429

请求过多

Request samples
curl --request GET \
  --url 'https://login.xsolla.com/api/oauth2/social/{provider_name}/login_redirect?redirect_uri=SOME_STRING_VALUE&client_id=SOME_INTEGER_VALUE&scope=SOME_STRING_VALUE&state=SOME_STRING_VALUE&response_type=SOME_STRING_VALUE&locale=SOME_STRING_VALUE'
Response samples
{
  • "error": {
    }
}