Xsolla-logoXsolla Developers
ou
Conta de Distribuidor

Update user attributes from server by server custom IDServer-side

post/projects/{project_id}/server_custom_id/{server_custom_id}/attributes

Updates and creates user attributes by user ID on your server (server_custom_id).

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

SecurityAttributesServer
Request
path Parameters
project_id
required
string <uuid>

Login project ID from Publisher Account.

server_custom_id
required
string

The server custom ID parameter is used to identify users in partner server.

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

404

Não encontrado

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