Xsolla-logo

Autenticación mediante ID personalizado

post/users/login/server_custom_id

Autentica a un usuario mediante un ID personalizado concreto. Si el usuario no existe, se crea.

SecurityServer
Request
query Parameters
projectId
string <uuid>

ID del proyecto de Login de Cuenta del editor. Si no lo especifica, se utilizará inicio de sesión concurrente para el parámetro especificado publisher_project_id.

ID de inicio de sesión concurrente que no necesita transmitir a esta llamada.

payload
string

Your custom data. The value of the parameter will be returned in the payload claim of the user JWT. Recommended maximum length less than 500 characters. Note, that this parameter is only available if you use a custom user data storage.

publisher_project_id
integer

ID del proyecto de Cuenta del editor para el que realiza la solicitud.

Si lo especifica, pero no especifica el parámetro project_id, el servicio se encontrará vinculado a su project_id. Contacte con su gestor del éxito del cliente para vincular project_id a publisher_project_id.

with_logout
string
Default: "0"

Indica si se desactivan los valores del JWT de usuario existentes y si se activa el valor generado por esta llamada. Puede tener los siguientes valores:

  • "1" para desactivar los valores existentes y activar uno nuevo,
  • "0" para mantener activados los valores existentes.
Request Body schema: application/json
server_custom_id
required
string <= 256 characters

Custom ID that already exists on your server. Note: It is not the same ID as the Xsolla Login user ID.

Array of objects

User attributes that are updated or created on authduring authentication.

Array
key
required
string <= 256 characters [A-Za-z0-9_]+

Nombre del atributo que se usa para identificar un atributo de usuario. Debe ser único para cada usuario.

value
required
any
attr_type
required
string

Definition of user’s access level to service attributes:

  • client - A user-editable attribute. The values for this type of attributes are entered by a user or specified according to the in-game logics on the client side. For example, the name and character stats, game difficulty level, etc.
  • server - A read-only attribute. The values for this type of attributes are entered and edited on the server side of your application. We recommend that you use them for configuration of game character stats or user parameters that shouldn’t change regularly. For example, chance to get a bonus, game character key parameters, user categories, etc.
Enum: "client" "server"
permission
required
string

Definición del nivel de acceso del usuario a los atributos de otros usuarios.

Enum: "private" "public"
read_only
boolean
object

User social profile.

user_id
required
string

ID de usuario de una plataforma de red social.

platform
required
string

Name of the social provider.

Responses
200

ACEPTAR

400

Bad Request (Solicitud errónea)

401

Unauthorized (No autorizado)

404

Not Found (No encontrado)

422

Unprocessable Entity (Entidad no procesable)

429

Too Many Requests (Demasiadas solicitudes)

Request samples
application/json
{
  • "attributes": [
    ],
  • "server_custom_id": "1234567890asdfghjkl",
  • "social_profile": {
    }
}
Response samples
application/json
{
  • "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJlbWFpbCI6IiIsImV4cCI6MTY1MzEyMzk5MCwiZ3JvdXBzIjpbXSwiaWF0IjoxNjUzMDM3NTkwLCJpc3MiOiJodHRwczovL2xvZ2luLnhzb2xsYS5jb20iLCJwdWJsaXNoZXJfaWQiOjMsInNlcnZlcl9jdXN0b21faWQiOiJteS1jdXN0b20taWQtbm90LWxpbmtlZCIsInN1YiI6IjI0MTBkNmMzLWFhZDEtNGY0OS04ODNlLTQ2Y2FkM2ZiMmJjMiIsInR5cGUiOiJzZXJ2ZXJfY3VzdG9tX2lkIiwidXNlcm5hbWUiOm51bGwsInhzb2xsYV9sb2dpbl9hY2Nlc3Nfa2V5IjoiSFhzTVZSWmRtd2tuZXNZMG1pNEpUMVhJUm43bVM4ZU5oc1FxaTU4bmtCayIsInhzb2xsYV9sb2dpbl9wcm9qZWN0X2lkIjoiMTM3NTkyM2ItODdmMy00YTIwLWFjMmItZDBhMjg3MzBlNDIwIn0.D8dFMN5Bmgnpejq1EhZUZQP_D5iFhpO_RXnVyE03qUI"
}