Autenticación mediante ID personalizado

Autenticación mediante ID personalizadoServer-side

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 Sus datos personalizados. El valor del parámetro será devuelto en la notificación `payload` del user JWT (JWT de usuario). Longitud máxima recomendada inferior a 500 caracteres. Tenga en cuenta que este parámetro únicamente está disponible si usa un almacenamiento de datos de usuario personalizado.
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

ID personalizado que ya existe en su servidor. Observación: No es el mismo ID que el ID de usuario de Xsolla Login.

Array of objects

Atributos de usuario que se actualizan o se crean al durante la autenticación.

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 Definición del nivel de acceso del usuario a los atributos de servicio: `client` - Un atributo modificable por el usuario. Los valores para este tipo de atributos son introducidos por el usuario o especificados de acuerdo con la lógica interna del juego en el lado del cliente. Por ejemplo, el nombre y las estadísticas del personaje, el nivel de dificultad del juego, etc. `server` - Atributo de solo lectura. Los valores de este tipo de atributos se introducen y editan en el lado del servidor de su aplicación. Le recomendamos que los use para configurar las estadísticas de los personajes del juego o los parámetros de usuario que no deberían cambiar frecuentemente. Por ejemplo, la posibilidad de obtener una bonificación, los parámetros clave del personaje del juego, categorías de usuario, 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

Perfil de redes sociales del usuario.

user_id required	string ID de usuario de una plataforma de red social.
platform required	string Nombre del proveedor de redes sociales.

object

User profile. This fields describe the user data.

nickname

required

string <= 255 characters

User nickname. The value will be added to the nickname field in the user JWT. Can't be empty. Spaces are allowed, but will be trimmed before and after the nickname. Can be non-unique. You can change the user's nickname value in the Xsolla system using the same method.

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": [{"attr_type": "server",
"key": "company",
"permission": "private",
"value": "facebook-promo"
},
{"attr_type": "server",
"key": "custom-id",
"permission": "private",
"value": 48582
}
],
"server_custom_id": "1234567890asdfghjkl",
"social_profile": {"platform": "xbox",
"user_id": 4352354
},
"user_profile": {"nickname": "John_Doe_1337"
}
}

Response samples

application/json

{"token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJlbWFpbCI6IiIsImV4cCI6MTY1MzEyMzk5MCwiZ3JvdXBzIjpbXSwiaWF0IjoxNjUzMDM3NTkwLCJpc3MiOiJodHRwczovL2xvZ2luLnhzb2xsYS5jb20iLCJwdWJsaXNoZXJfaWQiOjMsInNlcnZlcl9jdXN0b21faWQiOiJteS1jdXN0b20taWQtbm90LWxpbmtlZCIsInN1YiI6IjI0MTBkNmMzLWFhZDEtNGY0OS04ODNlLTQ2Y2FkM2ZiMmJjMiIsInR5cGUiOiJzZXJ2ZXJfY3VzdG9tX2lkIiwidXNlcm5hbWUiOm51bGwsInhzb2xsYV9sb2dpbl9hY2Nlc3Nfa2V5IjoiSFhzTVZSWmRtd2tuZXNZMG1pNEpUMVhJUm43bVM4ZU5oc1FxaTU4bmtCayIsInhzb2xsYV9sb2dpbl9wcm9qZWN0X2lkIjoiMTM3NTkyM2ItODdmMy00YTIwLWFjMmItZDBhMjg3MzBlNDIwIn0.D8dFMN5Bmgnpejq1EhZUZQP_D5iFhpO_RXnVyE03qUI"
}