Xsolla-logo

Actualizar los atributos del usuario desde el servidor

post/attributes/users/{user_id}/update

Updates and creates user’s attributes.

Notice
Rate limits for server-side methods limits are applied to this method.

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"

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"
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

Unprocessable Entity (Entidad no procesable)

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