Xsolla-logo

Autenticación mediante redes socialesClient-side

get/oauth2/social/{provider_name}/login_redirect

Redirige al usuario a la página para autenticación a través de la red social especificada.

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

Su ID de aplicación. Obténgalo después de crear un cliente de OAuth 2.0.

state
required
string

Valor utilizado para la verificación adicional del usuario. Se suele utilizar para mitigar los Ataques de CSRF. El valor se devolverá en la respuesta. Debe tener más de 8 caracteres.

response_type
required
string

Tipo de concesión utilizado en su proyecto que tiene habilitado el protocolo OAuth 2.0. Debe ser code para obtener el código de autenticación de usuario en la respuesta. El código recibido debe ser intercambiado por un JWT mediante la llamada Generate JWT para completar la autenticación del usuario.

redirect_uri
string

URL a la que redirigir al usuario tras la confirmación de cuenta, la autenticación aceptada o la confirmación de restablecimiento de contraseña. Para establecer este parámetro, contacte con su gestor del éxito del cliente o envíe un correo electrónico a csm@xsolla.com.

Aviso
El parámetro es obligatorio si tiene más de una URL de redireccionamiento en la configuración del proyecto.
scope
string

'Scope' (Ámbito) es un mecanismo en OAuth 2.0 para limitar el acceso de una aplicación a la cuenta de un usuario.

Puede ser:

  • email para las llamadas Auth via social network o Get link for social auth para solicitar, además, un correo electrónico del usuario.
  • offline para usar refresh_token de la llamada Generate JWT para actualizar el JWT cuando está expiraado.
  • playfab para escribir SessionTicket en la notificación session_ticket del JWT si almacena datos de usuario en PlayFab.

Si procesa sus propios valores del parámetro scope, que no se mencionan arriba, puede establecerlos al usar esta llamada. El servidor de Xsolla Login no procesa estos valores, sino que los devuelve en el JWT recibido.

Cuando se solicita el parámetro email y la red social no responde con el valor email:

  • se pedirá al usuario que introduzca un correo electrónico en el formulario correspondiente si ha integrado el Widget de Login,
  • se debe pedir al usuario que introduzca un correo electrónico en el formulario correspondiente de su propia interfaz si ha integrado Login API. Envíe la URL de este formulario a su gestor del éxito del cliente.

Una vez introducido el correo electrónico, el usuario recibe un mensaje de confirmación por correo electrónico. Para deshabilitar la confirmación por correo electrónico, contacte con su gestor del éxito del cliente.

locale
string >= 2 characters

Región en el formato <language code>_<country code>, en el cual:

La lista de redes sociales se ordenará de mayor a menor uso, según el valor de la variable.

Responses
302

Redireccionamiento

400

Bad Request (Solicitud errónea)

401

Bad Request (Solicitud errónea)

404

Not Found (No encontrado)

422

Unprocessable Entity (Entidad no procesable)

429

Too Many Requests (Demasiadas solicitudes)

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": {
    }
}