Xsolla-logo

Mettre à jour des attributs utilisateur depuis le serveur

post/attributes/users/{user_id}/update

Met à jour les attributs d'un utilisateur et en crée de nouveaux.

SecurityAttributesServer
Request
path Parameters
user_id
required
string <uuid>

ID utilisateur. Il se trouve dans le Compte éditeur sous Login settings > Users > Username/ID.

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

Votre ID de commerçant pour lequel la requête est faite. Nécessaire pour l'autorisation de la requête.

Array of objects

Liste des attributs du jeu spécifié. Pour ajouter un attribut qui n'existe pas, définissez cet attribut dans le paramètre key. Pour mettre à jour une value d'attribut, spécifiez son paramètre key et définissez la nouvelle value. Vous pouvez modifier plusieurs attributs à la fois.

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

Nom de l'attribut utilisé pour identifier l'attribut utilisateur. Il doit être unique pour chaque utilisateur.

value
required
string <= 256 characters

Valeur de l'attribut utilisateur.

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

Type de données de l'attribut

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

Description de l'attribut à partir du schéma JSON.

format
string or null

Format de l'attribut dans le schéma JSON. Valeurs possibles : date-time, date, time, duration, email, uri, uuid ou autre selon la spécification du schéma JSON.

permission
string or null

Définition du niveau d'accès de l'utilisateur aux attributs des autres utilisateurs.

Enum: "public" "private"
publisher_project_id
integer

ID de projet issu du Compte éditeur pour lequel vous souhaitez mettre à jour la valeur des attributs spécifiés. Si vous ne le spécifiez pas, la méthode met à jour uniquement les attributs qui sont généraux à tous les jeux.

removing_keys
Array of strings

Liste des attributs que vous voulez supprimer. Si vous spécifiez le même attribut dans le paramètre attributes, il ne sera pas supprimé.

Responses
204

No Content

400

Bad Request

403

Unprocessable Entity

422

Unprocessable Entity

429

Too Many Requests

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