Xsolla-logo

Benutzer anhand von Nickname suchenClient-side

get/users/search/by_nickname

Sucht Benutzer anhand des Parameters nickname und ruft eine Liste passender Benutzer ab. Die Suche beginnt unverzüglich mit der Eingabe des Suchparameters.

So sieht der Ablauf aus:

  1. Der Benutzer gibt den Nickname und/oder den Tag der gesuchten Person ein.
  2. Der Xsolla-Login-Server durchsucht die Login-Projektdaten des Benutzers, der eine Suche gestartet hat.

Der aktuelle Benutzer kann diesen Aufruf nur einmal pro Sekunde ausführen.

SecurityBearer
Request
query Parameters
nickname
required
string [ 3 .. 255 ] characters

Suchzeichenfolge, kann Folgendes enthalten:

  • Nur Nickname. Die Suche erfolgt anhand der Teilzeichenfolge am Anfang des Nicknames.
  • Nur Tag. Wird nur in Verbindung mit "#" am Anfang verwendet. Die Suche erfolgt anhand der Teilzeichenfolge am Anfang des Tags.
  • Nickname und Tag gemeinsam. Wird mit "#" und ohne Leerzeichen verwendet. Die Suche erfolgt anhand des vollständigen Nicknames und der Teilzeichenfolge am Anfang des Tags.
offset
integer [ 0 .. 100 ]
Default: 0

Anzahl der Elemente, aus denen die Liste generiert wird.

limit
integer [ 1 .. 100 ]
Default: 100

Maximale Anzahl von Benutzern, die gleichzeitig zurückgegeben werden.

Responses
200

OK

401

Unauthorized

422

Unprocessable Entity

429

Too Many Requests

Request samples
curl --request GET \
  --url 'https://login.xsolla.com/api/users/search/by_nickname?nickname=SOME_STRING_VALUE&offset=0&limit=100' \
  --header 'Authorization: Bearer BEARER_TOKEN'
Response samples
application/json
{
  • "offset": 3,
  • "total_count": 100,
  • "users": []
}