Xsolla-logo

Benutzer anhand von Attribut vom Server abrufen

post/attributes/users/get

Ruft eine Liste von Benutzern anhand eines Attributs ab. Gibt eine Liste mit den IDs der Benutzer, deren E-Mail-Adressen und den bei der Anfrage im ‘key’-Objekt angegeben Attributen zurück.

SecurityAttributesServer
Request
Request Body schema: application/json
required
object

Das Attribut dient dazu, die Benutzerliste abzurufen.

after
string or null

Aktualisierungsdatum des Benutzerattributs und ID des neusten Attributs in der keys-Liste. Legen Sie das Datum nicht beim ersten Mal fest. Wenn Sie Benutzer anhand eines Attributs abrufen, werden sie nach ihrem Aktualisierungsdatum sortiert. Wenn mehrere Attribute dasselbe Aktualisierungsdatum aufweisen, werden sie nach der Attribut-ID sortiert. Wird für die API-Paginierung verwendet.

attr_type
string
Default: "client"

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

Enum: "client" "server"
keys
Array of strings <= 5 items

Liste der Attributschlüssel, die Sie abrufen möchten. Wenn Sie nichts angeben, wird nur die Liste der Benutzer-IDs zurückgegeben.

limit
integer [ 0 .. 20 ]
Default: 20

Anzahl der Benutzer, die bei der Suche anhand von Attributen zurückgegeben wird.

login_project_id
string

Login ID from Publisher Account which you want to get user’s attributes for. If you do specify it, it is use instead your merchant ID and project ID from Publisher Account.

publisher_id
integer or null

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

publisher_project_id
integer

ID des Kundenportal-Projekts, dessen Benutzer Sie abrufen möchten. Wenn Sie keine ID angeben, werden Benutzer ohne den Wert dieses Parameters zurückgegeben.

search_type
string
Default: "equal"

Vergleichsbedingung, die die Suchkriterien definiert.

Enum: "equal" "like"
Responses
200

OK

400

Bad Request

403

Unprocessable Entity

422

Unprocessable Entity

429

Too Many Requests

Request samples
application/json
{
  • "after": "string",
  • "attr_type": "client",
  • "attribute": {
    },
  • "keys": [
    ],
  • "limit": 20,
  • "login_project_id": "string",
  • "publisher_id": 0,
  • "publisher_project_id": 0,
  • "search_type": "equal"
}
Response samples
application/json
[
  • {
    }
]