Xsolla-logo

Attribute des Benutzers auf dem Server aktualisieren

post/attributes/users/{user_id}/update

Aktualisiert und erstellt Benutzerattribute.

SecurityAttributesServer
Request
path Parameters
user_id
required
string <uuid>

Benutzer-ID. Diese finden Sie unter Kundenportal > Login-Einstellungen > Nutzer > Benutzername/ID.

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

Ihre Händler-ID, in deren Namen die Anfrage gestellt wird. Erforderlich, um die Anfrage zu autorisieren.

Array of objects

Liste der Attribute des angegebenen Spiels. Um ein nicht vorhandenes Attribut hinzuzufügen, müssen Sie für das Attribut einen key-Parameter festlegen. Um den value des Attributs zu aktualisieren, geben Sie dessen key-Parameter an, und legen Sie den neuen value fest. Es ist möglich, mehrere Attribute gleichzeitig zu ändern.

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

Name des Attributs, anhand dessen das Benutzerattribut identifiziert wird. Muss für jeden Benutzer eindeutig sein.

value
required
string <= 256 characters

Wert des Benutzerattributs.

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

Datentyp des Attributs

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

Beschreibung des Attributs aus dem JSON-Schema.

format
string or null

Format des Attributs aus dem JSON-Schema. Möglich sind date-time, date, time, duration, email, uri, uuid oder etwas anderes aus der JSON-Schemaspezifikation

permission
string or null

Festlegung der Zugriffsebene eines Benutzers für dessen Zugriff auf die Attribute anderer Benutzer.

Enum: "public" "private"
publisher_project_id
integer

ID des Kundenportal-Projekts, für das Sie den Wert der angegebenen Attribute aktualisieren möchten. Wenn Sie keine ID angeben, aktualisiert die Methode nur Attribute, die für alle Spiele gelten.

removing_keys
Array of strings

Liste der Attribute, die Sie löschen möchten. Wenn Sie dasselbe Attribut im Parameter attributes angeben, wird es nicht gelöscht.

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