Xsolla-logo

Atualize os atributos do usuário do servidor

post/attributes/users/{user_id}/update

Atualiza e cria atributos do usuário.

SecurityAttributesServer
Request
path Parameters
user_id
required
string <uuid>

ID de usuário. Você pode encontrá-lo em Conta de Distribuidor > Login settings > Users > Username/ID.

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

Seu ID de comerciante para o qual a solicitação é feita. Necessário para a autorização de solicitações.

Array of objects

Lista de atributos do jogo especificado. Para adicionar o atributo que não existe, defina esse atributo para o parâmetro key. Para atualizar value do atributo, especifique seu parâmetro key e defina o novo value. Você pode alterar vários atributos ao mesmo tempo.

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

Nome do atributo utilizado para identificar o atributo do usuário. Deve ser exclusivo para cada usuário.

value
required
string <= 256 characters

Valor do atributo do usuário.

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 dados do atributo.

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

Descrição do atributo do JSON Schema.

format
string or null

Formato do atributo do JSON Schema. Pode ser be date-time, date, time, duration, email, uri, uuid ou outro da especificação JSON Schema.

permission
string or null

Definição do nível de acesso do usuário aos atributos de outros usuários.

Enum: "public" "private"
publisher_project_id
integer

ID do projeto da Conta de Distribuidor para a qual você deseja atualizar o valor dos atributos especificados. Se você não especificá-lo, o método atualizará os atributos que são gerais apenas para todos os jogos.

removing_keys
Array of strings

Lista de atributos que você deseja excluir. Se você especificar o mesmo atributo no parâmetro attributes, ele não será excluído.

Responses
204

Sem conteúdo

400

Pedido incorreto

403

Entidade não processável

422

Entidade não processável

429

Pedidos demais

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