Xsolla-logo

Actualizar los atributos del usuario desde el servidorServer-side

post/attributes/users/{user_id}/update

Actualiza y crea los atributos del usuario.

SecurityAttributesServer
Request
path Parameters
user_id
required
string <uuid>

ID de usuario. Puede encontrarlo en Cuenta del editor > Login settings > Users > Username/ID.

Request Body schema: application/json
publisher_id
required
integer or null

Su ID de comerciante para el que se realiza la solicitud. Necesario para autorizar la solicitud.

Array of objects

Lista de atributos del juego especificado. Para agregar un atributo que no existe, establezca este atributo en el parámetro key. Para actualizar el value del atributo, especifique su parámetro key y establezca el nuevo value. Puede cambiar varios atributos a la vez.

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
string <= 256 characters

Valor del atributo del usuario.

attr_type
string
Default: "client"

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"
data_type
string or null

Tipo de datos del atributo.

Enum: "string" "number" "integer" "boolean"
description
string or null

Descripción del atributo a partir del esquema JSON.

format
string or null

Formato del atributo procedente del esquema JSON. Puede ser date-time, date, time, duration, email, uri, uuid u otro de la especificación del esquema JSON.

permission
string or null

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

Enum: "public" "private"
publisher_project_id
integer

ID del proyecto de la Cuenta del editor para la cual desea actualizar el valor de los atributos especificados. Si no lo especifica, el método solo actualiza los atributos generales de todos los juegos.

removing_keys
Array of strings

Lista de atributos que desea eliminar. Si especifica el mismo atributo en el parámetro attributes, no se eliminará.

Responses
204

No content (Sin contenido)

400

Bad Request (Solicitud errónea)

403

Forbidden (Prohibido)

422

Unprocessable Entity (Entidad no procesable)

429

Too Many Requests (Demasiadas solicitudes)

Request samples
application/json
{
  • "attributes": [
    ],
  • "publisher_id": 0,
  • "publisher_project_id": 0,
  • "removing_keys": [
    ]
}
Response samples
{
  • "error": {
    }
}