Xsolla-logo

Atualize os atributos do usuário do servidorServer-side

post/attributes/users/{user_id}/update

Atualiza e cria atributos do usuário.

Aviso
Limites de taxa para métodos do lado do servidor são aplicados a esse método.

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"

Definição do nível de acesso do usuário aos atributos de serviço:

  • client - Um atributo editável pelo usuário. Os valores para esse tipo de atributos são inseridos por um usuário ou especificados de acordo com as lógicas do jogo no lado do cliente. Por exemplo, o nome e estatísticas do personagem, nível de dificuldade do jogo, etc.
  • server - Um atributo somente de leitura. Os valores para esse tipo de atributo são inseridos e editados no lado do servidor do seu aplicativo. Recomendamos que você os use para configurar estatísticas de personagens do jogo ou parâmetros de usuário que não devem ser alterados regularmente. Por exemplo, chance de obter um bônus, parâmetros-chave de personagens do jogo, categorias de usuário, 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

Proibido

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