Xsolla-logo

Mettre à jour des attributs utilisateur depuis le serveurServer-side

post/attributes/users/{user_id}/update

Met à jour les attributs utilisateur et en crée.

Remarque
Les limites de fréquence pour les méthodes côté serveur s'appliquent à cette méthode.

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"

Définition du niveau d'accès de l'utilisateur aux attributs de service :

  • client : attribut modifiable par l'utilisateur. Les valeurs de ce type d'attributs sont saisies par l'utilisateur ou spécifiées selon la logique du jeu côté client. Par exemple : le nom et les statistiques du personnage, le niveau de difficulté du jeu, etc.
  • server : attribut en lecture seule. Les valeurs de ce type d'attributs sont saisies et modifiées côté serveur de votre application. Nous vous recommandons de les utiliser pour configurer les statistiques des personnages du jeu ou les paramètres utilisateur qui ne doivent pas changer régulièrement. Par exemple, les chances d'obtenir un bonus, les paramètres clés des personnages du jeu, les catégories d'utilisateurs, 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

Forbidden

422

Unprocessable Entity

429

Too Many Requests

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