So nutzen Sie die API-Aufrufe des Login Widget SDK

Sie können die API-Aufrufe des Login Widget SDK getrennt vom Login-Widget nutzen, wenn Sie:

  • Ihr eigenes Widget-Design verwenden möchten
  • den Ablauf des Login-Widgets nur teilweise implementieren möchten

Hinweis
Nicht alle API-Aufrufe unterstützen dieses Szenario.

Code-Initialisierung

Um die API-Aufrufe des Login Widget SDK ohne Widget zu verwenden, binden Sie den folgenden Code in den <body>-Tag ein:

Copy
Full screen
Small screen
1<script>
2const api = new XsollaLogin.Api({
3  projectId: 'someProjectId'
4});
5</script>

Initialisierungscode bei Verwendung eines npm-Pakets:

Copy
Full screen
Small screen
1import XsollaLogin from '@xsolla/login-sdk';
2const api = new XsollaLogin.Api({
3  projectId: 'someProjectId'
4});

Die folgenden Parameter werden im Initialisierungscode übermittelt:

ParameterTypBeschreibung
projectId
stringID Ihres Login-Projekts aus dem Kundenportal. Erforderlich.
fullLocale
stringSprache der Benutzeroberfläche und eine Region im Format <language code>_<country code>, wobei:Die folgenden Sprachen werden unterstützt: Arabisch (ar_AE), Bulgarisch (bg_BG), Tschechisch (cz_CZ), Filipino (fil_PH), Englisch (en_XX), Deutsch (de_DE), Spanisch (es_ES), Französisch (fr_FR), Hebräisch (he_IL), Indonesisch (id_ID), Italienisch (it_IT), Japanisch (ja_JP), Khmer (km-KH), Koreanisch (ko_KR), Laotisch (lo_LA), Myanmar (my_MM), Nepali (ne_NP), Polnisch (pl_PL), Portugiesisch (pt_BR), Rumänisch (ro_RO), Russisch (ru_RU), Thailändisch (th_TH), Türkisch (tr_TR), Vietnamesisch (vi_VN), Vereinfachtes Chinesisch (zh_CN), Traditionelles Chinesisch (zh_TW).
Der Parameter beeinflusst die Reihenfolge der sozialen Netzwerke, da diese nach deren Benutzungshäufigkeit in der angegebenen Region angeordnet sind. Außerdem bestimmt er die Sprache, in der die E-Mails an die Nutzer versendet werden.
callbackUrl
stringDie URL, mit der der Xsolla Login-Server arbeitet, sofern die Anmeldung oder Registrierung erfolgreich war.
emailTemplate
stringDer Name des Projekts, in dessen Namen die E-Mails an die Benutzer gesendet werden.
payload
stringZusätzliche Daten, die in einem Code übermittelt werden können. Diese Daten werden nach erfolgreicher Anmeldung dem Benutzer-JWT hinzugefügt.
with_logout
booleanLegt fest, ob ältere Token bei einer erneuten Anmeldung widerrufen werden sollen. false ist voreingestellt.
clientId
stringID der Client-App. Wird übermittelt, wenn die auf dem OAuth 2.0-Protokoll basierende Authentifizierung in der App zum Einsatz kommt.
scope
stringZusätzliche Angaben über ein von der Anwendung angefordertes Benutzerkonto. Wird übermittelt, wenn die auf dem OAuth 2.0-Protokoll basierende Authentifizierung in der App zum Einsatz kommt. Mögliche Werte:
  • email – Zusätzliche Abfrage der E-Mail-Adresse, wenn sich der Benutzer über ein soziales Netzwerk anmeldet.
  • offline – Automatische Aktualisierung des JWT nach Ablauf seiner Gültigkeit.
  • playfab – Der Parameter SessionTicket wird automatisch an ein JWT übermittelt, wenn die Benutzerdaten in PlayFab gespeichert sind.
Sie können auch Ihre eigenen Parameter angeben. Der Xsolla Login-Server verarbeitet sie nicht, sondern gibt sie in einem JWT zurück.
state
stringEine zusätzliche Benutzerverifizierung, um beispielsweise CSRF-Attacken zu verhindern. Mindestlänge: 8 Zeichen.
redirectUrl
stringDie URL, zu der der Benutzer weitergeleitet wird, nachdem er sein Konto bestätigt, sich angemeldet oder das Passwort zurückgesetzt hat.
booleanOb die Bestätigung der passwortlosen Authentifizierung per Klick auf einen Link in der E-Mail deaktiviert werden soll, wenn sich Benutzer ohne Passwort per E-Mail-Adresse oder Telefonnummer anmelden. false ist voreingestellt.
is_oauth2
booleanLegt fest, ob die auf dem OAuth 2.0-Protokoll basierende Authentifizierung für Nutzer zum Einsatz kommt. false ist voreingestellt.

API-Aufrufe

Folgende API-Aufrufe des Login Widget SDK lassen sich auch ohne Login-Widget nutzen:

Benutzerregistrierung per Passwort

AufrufBeschreibungParameter
api.signup(userInfo);Registriert einen neuen Benutzer. Die Bentzerdaten werden während der Registrierung im userInfo-Objekt übermittelt. Der Token des registrierten Benutzers wird in der Antwort übermittelt.
  • email (string) — E-Mail-Adresse des Benutzers. Erforderlich.
  • username (string) — Benutzername. Erforderlich.
  • password (string) — Benutzerpasswort. Erforderlich.
  • nickname (string) — Nickname des Benutzers.
Beispiel:
Copy
Full screen
Small screen
 1let result
 2// Request
 3api.signup({
 4  userInfo: {
 5    email: 'email@address.com',
 6    fields: {
 7      nickname: 'Johny'
 8    },
 9    password: 'password123',
10    username: 'John'
11  }
12}).then((res) => {
13  result = res;
14})
15
16// Response
17result === {
18  login_url: 'https://someurl.com?token=XXXXXXX'
19}

Anmelden mit Passwort

AufrufBeschreibungParameter
api.login(credentials);Authentifiziert einen Benutzer anhand eines Passworts. Die für die Benutzeranmeldung erforderlichen Benutzerdaten werden im credentials-Objekt übermittelt. Der Token des authentifizierten Benutzers wird in der Antwort übermittelt.
  • username (string) – Benutzername, z. B.: John, oder eine E-Mail-Adresse, z. B.: email@address.com. Erforderlich.
  • password (string) – Benutzerpasswort. Erforderlich.
Beispiel:
Copy
Full screen
Small screen
 1let result
 2// Request
 3api.login({
 4  credentials: {
 5    password: 'password123',
 6    username: 'email@address.com'
 7  }
 8}).then((res) => {
 9  result = res;
10})
11
12// Response
13result === {
14  login_url: 'https://someurl.com?token=XXXXXXX'
15}
16
17// Response with additional fields
18result === {
19  ask_fields: [{
20    confirmation_type: 'code' || 'link'
21    name: 'phone_number'
22    required: false
23    step: 0 // Displays the position of the field in the data retrieval queue.
24    type: 'phone'
25    validation: {} // Custom validation
26  }]
27  login_url: 'https://someurl.com?token=XXXXXXX',
28  token: 'sometoken'
29}

Kontobestätigung

AufrufBeschreibungParameter
api.resendEmail(username);Sendet eine weitere E-Mail zur Bestätigung des Kontos. Um das Konto zu bestätigen, sollte der Benutzer auf den Link in der E-Mail klicken. Die E-Mail-Adresse des Benutzers wird im Objekt username übermittelt. Als Antwort wird der Standardcode 204 zurückgegeben.
  • username (string) – E-Mail-Adresse des Benutzers, z. B.: email@address.com. Erforderlich.
Beispiel:
Copy
Full screen
Small screen
1// Request
2api.resendEmail({
3  username: "email@address.com"
4}).then((res) => {
5  if (res.code === 204) {
6    console.log("Email resend success");
7  }
8});

Passwortlose Authentifizierung

Ablauf für den Nutzer:

  1. Der Benutzer gibt seine Telefonnummer oder E-Mail-Adresse ein. Je nach den eingegebenen Anmeldedaten wird entweder api.phoneGetCode oder api.emailGetCode aufgerufen.
  2. Der Server empfängt die Daten und sendet einen Code per E-Mail oder SMS an den Benutzer. Wird beim Initialisieren des Codes der Parameter disableConfirmByLink=true (deaktiviert die Anmeldebestätigung über den Link in der E-Mail) übermittelt, wird für die automatische Weiterleitung des Benutzers nach dem Anklicken des Links der Aufruf api.getConfirmCode verwendet.
  3. Als Antwort auf den Aufruf api.phoneGetCode bzw. api.emailGetCode erhält man den Parameter operation_id, mit dem sich die Telefonnummer bzw. die E-Mail-Adresse durch den Aufruf api.loginWithPhoneCode bzw. api.loginWithEmailCode bestätigen lässt.
  4. Nachdem die E-Mail-Adresse bzw. die Telefonnummer erfolgreich bestätigt wurde, erhält man als Antwort die URL mit dem token-Parameter. Damit lassen sich zusätzliche Daten über den Benutzer abfragen.

AufrufBeschreibungParameter
api.phoneGetCode({ phone_number, link_url, isOauth2 });Sendet einen Bestätigungscode an die Telefonnummer. Der zur Bestätigung der Telefonnummer verwendete operation_id-Parameter wird in der Antwort zurückgegeben.
  • phone_number (string) – Telefonnummer für die passwortlose Authentifizierung.
  • link_url (string) – Bestätigungs-URL.
  • isOauth2 (boolean) – Ob die auf dem OAuth 2.0-Protokoll basierende Authentifizierung für Benutzer verwendet werden soll. Erforderlich.
Beispiel:
Copy
Full screen
Small screen
 1let result
 2// Request
 3api.phoneGetCode({
 4  phone_number: '+somenumber',
 5  link_url: 'https://someurl.com',
 6  isOauth2: true
 7}).then((res) => {
 8  result = res;
 9})
10
11// Response
12result === {
13  operation_id: '2334j255fdf13d515fgd1'
14}
AufrufBeschreibungParameter
api.phoneGetCode({ phone_number, link_url, isOauth2 });Sendet einen Bestätigungscode an die E-Mail-Adresse. Der zur Bestätigung der E-Mail-Adresse verwendete operation_id-Parameter wird in der Antwort zurückgegeben.
  • email (string) – E-Mail-Adresse für die passwortlose Authentifizierung.
  • link_url (string) – Bestätigungs-URL.
  • isOauth2 (boolean) – Ob die auf dem OAuth 2.0-Protokoll basierende Authentifizierung für Benutzer verwendet werden soll. Erforderlich.
Beispiel:
Copy
Full screen
Small screen
 1let result
 2// Request
 3api.emailGetCode({
 4  email: 'email@address.com',
 5  link_url: 'https://someurl.com',
 6  isOauth2: true
 7}).then((res) => {
 8  result = res;
 9})
10
11// Response
12result === {
13  operation_id: '2334j255fdf13d515fgd1'
14}
AufrufBeschreibungParameter
api.getConfirmCode({ cancelToken, login, operation_id });Ruft einen Bestätigungscode ab, um den Benutzer nach Klick auf den Link automatisch weiterzuleiten.
  • cancelToken (string) – Individueller Token zum Beenden der Sitzung. Erforderlich.
  • login (string) – Telefonnummer oder E-Mail Adresse des Benutzers. Erforderlich.
  • operation_id (string) – Individuelle Kennung, die zur Bestätigung einer Telefonnummer oder E-Mail-Adresse eines Benutzers während einer laufenden Sitzung verwendet wird. Erforderlich.
Beispiel:
Copy
Full screen
Small screen
 1let result
 2// Request
 3const axiosCancelToken = Axios.CancelToken.source();
 4
 5api.getConfirmCode({
 6  cancelToken: axiosCancelToken,
 7  login: '+somenumber' || 'email@address.com',
 8  operation_id: '334j255fdf13d515fgd1'
 9}).then((res) => {
10  result = res;
11})
12
13// Response
14result === {
15  code: 'string'
16}
17
18// If the waiting time has elapsed, returns:
19result === {
20  error: {
21    code: '010-050',
22    description: 'Deadline exceeded.'
23  }
24}
25
26// If you no longer need to wait for verification through the link you can close the request waiting period:
27axiosCancelToken.cancel();
AufrufBeschreibungParameter
api.loginWithPhoneCode({ phone_number, Code, operation_id, isOauth2 });Bestätigt die Telefonnummer. Als Antwort erhält man die URL mit dem Parameter token. Dieser wird bei der Abfrage zusätzlicher Daten über den Nutzer verwendet.
  • phone_number (string) – Telefonnummer für die passwortlose Authentifizierung.
  • code (string) – Bestätigungscode, der per SMS versendet wird.
  • operation_id (string) – Individuelle Kennung, die zur Bestätigung der Benutzer-Telefonnummer während einer laufenden Sitzung verwendet wird.
  • isOauth2 (boolean) – Ob die auf dem OAuth 2.0-Protokoll basierende Authentifizierung für Benutzer verwendet werden soll. Erforderlich.
Beispiel:
Copy
Full screen
Small screen
 1let result
 2// Request
 3api.loginWithPhoneCode({
 4  phone_number: 'email@address.com',
 5  code: '3423',
 6  operation_id: '334j255fdf13d515fgd1',
 7  isOauth2: true
 8}).then((res) => {
 9  result = res;
10})
11
12// Response
13result === {
14  login_url: 'https://someurl.com?token=XXXXXXX'
15}
16
17
18// Response with additional fields
19result === {
20  ask_fields: [{
21    confirmation_type: 'code' || 'link'
22    name: 'email'
23    required: false
24    step: 0 // Displays the position of the field in the data retrieval queue.
25    type: 'email'
26    validation: {} // Custom validation
27  }]
28  login_url: 'https://someurl.com?token=XXXXXXX',
29  token: 'sometoken'
30}
AufrufBeschreibungParameter
api.loginWithEmailCode({ email, code, operation_id, isOauth2 });Bestätigt die E-Mail-Adresse. Als Antwort erhält man die URL mit dem Parameter token. Dieser wird bei der Abfrage zusätzlicher Daten über den Nutzer verwendet.
  • email (string) – E-Mail-Adresse für die passwortlose Authentifizierung.
  • code (string) – der per E-Mail versendete Bestätigungscode.
  • operation_id (string) – Individuelle Kennung, die zur Bestätigung der E-Mail-Adresse während einer laufenden Sitzung verwendet wird.
  • isOauth2 (boolean) – Ob die auf dem OAuth 2.0-Protokoll basierende Authentifizierung für Benutzer verwendet werden soll. Erforderlich.
Beispiel:
Copy
Full screen
Small screen
 1let result
 2// Request
 3api.loginWithEmailCode({
 4  email: 'email@address.com',
 5  code: '3423',
 6  operation_id: '334j255fdf13d515fgd1',
 7  isOauth2: true
 8}).then((res) => {
 9  result = res;
10})
11
12// Response
13result === {
14  login_url: 'https://someurl.com?token=XXXXXXX'
15}
16
17// Response with additional fields
18result === {
19  ask_fields: [{
20    confirmation_type: 'code' || 'link'
21    name: 'phone_number'
22    required: false
23    step: 0 // Displays the position of the field in the data retrieval queue.
24    type: 'phone'
25    validation: {} // Custom validation
26  }]
27  login_url: 'https://someurl.com?token=XXXXXXX',
28  token: 'sometoken'
29}

Felder für zusätzliche Abfragen ohne Passwort

Ablauf für den Nutzer:

  1. Nach erfolgreicher Authentifizierung eines Benutzers erhält man als Antwort auf den Aufruf api.loginWithEmailCode oder api.loginWithPhoneCode ein Array von Feldern, die in einer App in einem separaten Formular angezeigt werden können und mit denen sich zusätzlich die Telefonnummer und die E-Mail-Adresse des Benutzers erfassen lassen. Die Liste der Felder lässt sich ebenfalls über den Aufruf api.getAskFields abrufen.
  2. Der Benutzer gibt seine Telefonnummer oder E-Mail-Adresse ein. Anschließend wird der api.ask-Aufruf ausgeführt.
  3. Der Server empfängt die Daten und sendet einen Bestätigungscode an eine Telefonnummer oder E-Mail-Adresse. Wird beim Initialisieren des Codes der Parameter disableConfirmByLink=true (deaktiviert die Anmeldebestätigung über den Link in der E-Mail) übermittelt, wird für die automatische Weiterleitung des Benutzers nach dem Anklicken des Links der Aufruf api.getConfirmCode verwendet.
  4. Als Antwort auf den Aufruf api.ask erhält man den Parameter operation_id, mit dem sich die Telefonnummer bzw. die E-Mail-Adresse durch den Aufruf api.loginWithPhoneCode bzw. api.loginWithEmailCode bestätigen lässt.
  5. Nach erfolgreicher Datenbestätigung erhält man als Antwort die URL, an die ein authentifizierter Benutzer weitergeleitet wird.

AufrufBeschreibungParameter
api.getAskFields(token);Ruft die Liste der Felder für weitere Abfragen ab.
  • token (string) – Benutzer-JWT. Erforderlich.
Beispiel:
Copy
Full screen
Small screen
 1let result
 2// Request
 3api.getAskFields({
 4  token: 'sometoken'
 5}).then((res) => {
 6  result = res;
 7})
 8
 9// Response
10result === [
11  {
12    confirmation_type: 'code' || 'link'
13    name: 'phone_number' || 'email'
14    required: false
15    step: 0 // Displays the position of the field in the data retrieval queue.
16    type: 'phone' || 'email'
17    validation: {} // Custom validation
18  }
19]
AufrufBeschreibungParameter
api.ask({ fields, token, link_url });Sendet zusätzliche Daten (Telefonnummer oder E-Mail-Adresse) über den Benutzer. Der zur Bestätigung der angegebenen Telefonnummer oder E-Mail-Adresse genutzte operation_id-Parameter wird in der Antwort zurückgegeben. Wenn keine Bestätigung erforderlich ist, wird in der Antwort die URL mit dem token-Parameter zurückgegeben, an die ein authentifizierter Benutzer weitergeleitet wird.
  • fields (object) – Objekt, in dem die Telefonnummer oder E-Mail-Adresse des Benutzers übermittelt wird. Erforderlich.
  • token (string) – Benutzer-JWT. Erforderlich.
  • link_url (string) – Bestätigungs-URL.
Beispiel für das Senden einer Telefonnummer:
Copy
Full screen
Small screen
 1let result
 2// Request
 3api.ask({
 4  fields: {  
 5    phone_number: '+somenumber'
 6  },
 7  link_url: 'https://someurl.com',
 8  token: 'sometoken'
 9}).then((res) => {
10  result = res;
11})
12
13// Response
14result === {
15  error: {
16    code: '003-014'
17    description: 'Confirm phone number.'
18    details: { operation_id: 'BPaBScLM44GesoOYSxT5I8QfgIrTSURd' }
19  }
20}
21
22// Response without confirmation
23result === {
24  redirect_url: '<login_url>?token=<token>'
25}

Beispiel für das Senden einer E-Mail-Adresse:

Copy
Full screen
Small screen
 1let result
 2// request
 3api.ask({
 4  fields: {  
 5    email: 'email@address.com'
 6  },
 7  link_url: 'https://someurl.com',
 8  token: 'sometoken'
 9}).then((res) => {
10  result = res;
11})
12
13// Response
14result === {
15  error: {
16    code: '003-011'
17    description: 'Confirm email.'
18    details: { operation_id: 'BPaBScLM44GesoOYSxT5I8QfgIrTSURd' }
19  }
20}
21
22// Response without confirmation
23result === {
24  redirect_url: '<login_url>?token=<token>'
25}
AufrufBeschreibungParameter
api.getConfirmCode({ cancelToken, login, operation_id });Ruft den Bestätigungscode ab, um den Benutzer nach Klick auf den Link automatisch weiterzuleiten.
  • cancelToken (string) – Individueller Token zum Beenden der Sitzung. Erforderlich.
  • login (string) – Telefonnummer oder E-Mail-Adresse des Benutzers. Erforderlich.
  • operation_id (string) – Individuelle Kennung, die zur Bestätigung einer Telefonnummer oder E-Mail-Adresse eines Benutzers während einer laufenden Sitzung verwendet wird. Erforderlich.
Beispiel:
Copy
Full screen
Small screen
 1let result
 2// Request
 3const axiosCancelToken = Axios.CancelToken.source();
 4
 5api.getConfirmCode({
 6  cancelToken: axiosCancelToken,
 7  login: '+somenumber' || 'email@address.com',
 8  operation_id: '334j255fdf13d515fgd1'
 9}).then((res) => {
10  result = res;
11})
12
13// Response
14result === {
15  code: 'string'
16}
17
18// If the waiting time has elapsed, returns:
19result === {
20  error: {
21    code: '010-050',
22    description: 'Deadline exceeded.'
23  }
24}
25
26// If you no longer need to wait for verification through the link you can close the request waiting period:
27axiosCancelToken.cancel();
AufrufBeschreibungParameter
api.loginWithPhoneCode({ phone_number, code, operation_id, isOauth2 });Bestätigt die Telefonnummer. Als Antwort erhält man die URL mit dem Parameter token. Dieser wird bei der Abfrage zusätzlicher Daten über den Nutzer verwendet.
  • phone_number (string) – Telefonnummer für die passwortlose Authentifizierung.
  • code (string) – Der per SMS versendete Bestätigungscode.
  • operation_id (string) – Individuelle Kennung, die zur Bestätigung der Benutzer-Telefonnummer während einer laufenden Sitzung verwendet wird.
  • isOauth2 (boolean) – Ob die auf dem OAuth 2.0-Protokoll basierende Authentifizierung für Benutzer verwendet werden soll. Erforderlich.
Beispiel:
Copy
Full screen
Small screen
 1let result
 2// Request
 3api.loginWithPhoneCode({
 4  phone_number: 'email@address.com',
 5  code: '3423',
 6  operation_id: '334j255fdf13d515fgd1',
 7  isOauth2: true
 8}).then((res) => {
 9  result = res;
10})
11
12// Response
13result === {
14  login_url: 'https://someurl.com?token=XXXXXXX'
15}
16
17
18// Response with additional fields
19result === {
20  ask_fields: [{
21    confirmation_type: 'code' || 'link'
22    name: 'email'
23    required: false
24    step: 0 // Displays the position of the field in the data retrieval queue.
25    type: 'email'
26    validation: {} // Custom validation
27  }]
28  login_url: 'https://someurl.com?token=XXXXXXX',
29  token: 'sometoken'
30}
AufrufBeschreibungParameter
api.loginWithEmailCode({ email, code, operation_id, isOauth2 });Bestätigt die E-Mail-Adresse. Als Antwort erhält man die URL mit dem Parameter token. Dieser wird bei der Abfrage zusätzlicher Daten über den Nutzer verwendet.
  • email (string) – E-Mail-Adresse für die passwortlose Authentifizierung.
  • code (string) – Der an die E-Mail-Adresse gesendete Bestätigungscode.
  • operation_id (string) – Individuelle Kennung, die zur Bestätigung der E-Mail-Adresse eines Benutzers während einer laufenden Sitzung verwendet wird.
  • isOauth2 (boolean) – Ob die auf dem OAuth 2.0-Protokoll basierende Authentifizierung für Benutzer verwendet werden soll. Erforderlich.
Beispiel:
Copy
Full screen
Small screen
 1let result
 2// Request
 3api.loginWithEmailCode({
 4  email: 'email@address.com',
 5  code: '3423',
 6  operation_id: '334j255fdf13d515fgd1',
 7  isOauth2: true
 8}).then((res) => {
 9  result = res;
10})
11
12// Response
13result === {
14  login_url: 'https://someurl.com?token=XXXXXXX'
15}
16
17// Response with additional fields
18result === {
19  ask_fields: [{
20    confirmation_type: 'code' || 'link'
21    name: 'phone_number'
22    required: false
23    step: 0 // Displays the position of the field in the data retrieval queue.
24    type: 'phone'
25    validation: {} // Custom validation
26  }]
27  login_url: 'https://someurl.com?token=XXXXXXX',
28  token: 'sometoken'
29}

Zurücksetzen von Passwörtern

Ablauf für den Nutzer:

  1. Die Anwendung öffnet ein Formular, in das der Benutzer seine E-Mail-Adresse oder seinen Benutzernamen eingibt. Anschließend wird der api.reset-Aufruf ausgeführt.
  2. Der Server sendet eine Bestätigung per E-Mail an den Benutzer.
  3. Der Benutzer klickt auf den Link in der E-Mail, woraufhin sich ein Formular öffnet.
  4. Dort gibt der Benutzer ein neues Passwort ein. Anschließend wird der api.set-Aufruf ausgeführt.

AufrufBeschreibungParameter
api.reset(username);Setzt das Passwort zurück und bestätigt die Aktion. Um das Zurücksetzen des Passworts zu bestätigen, muss der Benutzer auf den Link in der E-Mail klicken. Der Benutzername oder die E-Mail-Adresse des Benutzers wird im username-Objekt übermittelt. Als Antwort wird der Code 204 zurückgegeben.
  • username (string) – Benutzername, z. B.: John, oder eine E-Mail-Adresse, z. B.: email@address.com. Erforderlich.
Beispiel:
Copy
Full screen
Small screen
1let result
2// Request
3api.reset({
4  username: 'John'
5}).then((res) => {
6  res.code === 204;
7})
AufrufBeschreibungParameter
api.set({ new_password, reset_code, user_id });Legt ein neues Passwort fest und bestätigt die Aktion. Um ein neues Passwort zu bestätigen, muss der Benutzer auf den Link in der E-Mail klicken. Als Antwort wird der Code 204 zurückgegeben.
  • new_password (string) – Ein vom Benutzer eingegebenes neues Passwort. Erforderlich.
  • reset_code (string) – Ein Code für die Verifikation eines Benutzers, der eine Anfrage zum Zurücksetzen seines Passworts gesendet hat. Der Code wird serverseitig generiert und in der URL übermittelt, zu der der Benutzer nach Klick auf den Link in der E-Mail weitergeleitet wird. Erforderlich.
  • user_id (string) – Benutzerkennung. Wird serverseitig generiert und in der URL übermittelt, zu der der Benutzer nach Klick auf den Link in der E-Mail weitergeleitet wird. Erforderlich.
Beispiel:
Copy
Full screen
Small screen
1let result
2// Request
3api.set({
4  new_password: 'newpass',
5  reset_code: '3423',
6  user_id: '324324234'
7}).then((res) => {
8  res.code === 204;
9})

Single Sign-On

Hinweis
Ausführliche Informationen finden Sie in der Anleitung über den Single Sign-On.
ParameterTypBeschreibung
api.checkUserAuthSSO();
Prüft, ob ein Benutzer über Single Sign-On autorisiert ist. Wenn dem so ist, wird ein Einmalcode (code) zurückgegeben.
Beispiel:
Copy
Full screen
Small screen
 1let result
 2// Request
 3api
 4  .checkUserAuthSSO()
 5  .then(res => {
 6    result === res;
 7  });
 8
 9result === {
10  code: "examplecode"
11}
AufrufBeschreibungParameter
api.userAuthSSOWithRedirect(loginUrl);Prüft, ob ein Benutzer über Single Sign-On autorisiert wurde. Wenn dem so ist, wird der Benutzer zur URL weitergeleitet; die generierte loginUrl enthält einen Autorisierungscode.
  • loginUrl (string) – URL, an die ein Benutzer nach einer SSO-Prüfung weitergeleitet wird. Muss mit der Rückruf-URL übereinstimmen, die im Kundenportal unter Ihr Login-Projekt > Allgemeine Einstellungen im Block URL angegeben ist. Erforderlich, wenn es mehrere URL-Adressen gibt, an die ein Benutzer weitergeleitet werden kann.
Beispiel:
Copy
Full screen
Small screen
1// Request
2api
3  .userAuthSSOWithRedirect(
4    loginUrl: 'some-redirect-url.com'
5  )
6  .then(res => {
7    res.code === 302;
8  });
AufrufBeschreibungParameter
api.logout(token, session);Meldet einen Benutzer aus dem System ab und löscht eine Benutzersitzung entsprechend dem Parameter session.
  • token (string) – Benutzer-JWT. Erforderlich.
  • session (string) – zeigt, wie sich ein Benutzer aus dem System abmeldet und wie seine Sitzung gelöscht wird. Erforderlich. Möglich sind:
    • sso — löscht nur die SSO-Benutzersitzung.
    • all — löscht die SSO-Benutzersitzung und alle Zugriffstoken sowie Aktualisierungen.
Beispiel:
Copy
Full screen
Small screen
1// Request
2api
3  .logout(
4    token: 'exampleToken',
5    session: 'sso' | 'all'
6  )
7  .then(res => {
8    res.code === 204;
9  });
ParameterTypBeschreibung
api.clearSSO();
Entfernt die für den Single-Sign-on zuständigen Cookie-Dateien vom aktuellen Gerät des Benutzers. Bei einem erfolgreichem Aufruf wird in der Antwort der Code 204 zurückgegeben.
Beispiel:
Copy
Full screen
Small screen
1// Request
2api
3  .clearSSO()
4  .then(() => {
5    // Success
6  });
War dieser Artikel hilfreich?
Vielen Dank!
Gibt es etwas, das wir verbessern können? Nachricht
Das tut uns leid
Bitte erläutern Sie, weshalb dieser Artikel nicht hilfreich ist. Nachricht
Vielen Dank für Ihr Feedback!
Wir werden Ihr Feedback aufgreifen und dazu nutzen, Ihr Erlebnis verbessern.
Letztmalig aktualisiert: 19. September 2025

Haben Sie einen Tippfehler oder einen anderen Textfehler gefunden? Wählen Sie den Text aus und drücken Sie Strg+Eingabe.

Problem melden
Wir überprüfen unsere Inhalte ständig. Ihr Feedback hilft uns, sie zu verbessern.
Geben Sie eine E-Mail-Adresse an, damit wir Sie erreichen können
Vielen Dank für Ihr Feedback!
Ihr Feedback konnte nicht gesendet werden
Versuchen Sie es später erneut oder kontaktieren Sie uns unter doc_feedback@xsolla.com.