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"

Festlegung der Zugriffsebene eines Benutzers für dessen Zugriff auf Dienstattribute:

  • client – Vom Benutzer editierbares Attribut. Die Werte für diesen Attributtyp werden von einem Benutzer eingegeben oder entsprechend der Ingame-Logik clientseitig festgelegt. Zum Beispiel: Name und Eigenschaften des Spielercharakters, Schwierigkeitsgrad des Spiels usw.
  • server – Schreibgeschütztes Attribute. Die Werte für diesen Attributtyp werden aufseiten des Anwendungsservers eingegeben und bearbeitet. Wir empfehlen Ihnen, diese Attribute für die Konfiguration von Spielercharaktereigenschaften oder Benutzerparametern zu verwenden, die nicht so oft geändert werden sollen. Zum Beispiel: Wahrscheinlichkeit für das Erhalten einen Bonus, Schlüsselparameter von Spielercharakteren, Benutzerkategorien usw.
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, werden nur Attribute aktualisiert, 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": {
    }
}