API:Account creation/de

Erstellen eines Kontos
Der Prozess umfasst drei Schritte:


 * 1) Erhalte die Felder aus  und das Token aus.
 * 2) Sende eine POST-Abfrage mit dem erhaltenen Token, Benutzerinformation und anderen Feldern und gib die URL an die API.
 * 3) Gehe mit der Antwort um, was weitere POST-Abfragen beinhalten kann, um weitere Informationen zu erhalten.

Beispiel 1: Prozess für ein Wiki ohne spezielle Authentifizierungserweiterungen
Bei einem Wiki ohne spezielle Authentifizierungs-Erweiterungen kann der Prozess recht einfach sein. Wenn dein Code weiß, welche Felder erforderlich sind, wird die Abfrage an möglicherweise übersprungen und nur angenommen, welche Felder benötigt werden (d.h. Benutzername, Passwort &amp; Wiederholung des Passwortes, Email, eventuell Realname).

Beispiel 2: Prozess für ein Wiki mit einer CAPTCHA-Erweiterung
Beachte, dass der erste Schritt unten auch in zwei Schritten erfolgen kann: Einem zum Erhalt der Felder aus und einem weiteren zum Erhalt des Tokens aus.

Beispielcode
Beachte, dass dieses Code-Beispiel die Abfragen und  trennt und allgemein annimmt, dass es ein CAPTCHA und keine anderen Komplikationen gibt.

Erster Schritt: Felder aus füllen und Token aus  erhalten
Der Erhalt von und  erfolgt größtenteils so wie im vorherigen Beispiel und wird hier deshalb nicht wiederholt. Die von ausgegebene Liste von Abfragen wird Definitionen für die CAPTCHA-Erweiterung und die OpenUD-Erweiterung enthalten.

Zweiter Schritt: ausfüllen der CAPTCHA und Auswahl von OpenID-Authentifikation
Vom Client wird erwartet, den Browser des Benutzers zum bereitgestellten redirecttarget weiterzuleiten.

Der OpenID-Anbieter sollte authentifizieren und zu Special:OpenIDConnectReturn im Wiki weiterleiten, was die OpenID-Antwort validieren würde und dann weiterleiten zur createreturnurl, die im ersten POST an die API bereitgestellt wurde, mit angehängten code - und state -Parametern.

Der Client erhält an diesem Punkt die Kontrolle über den Prozess zurück und macht seine nächste API-Anfrage.

Dritter Schritt: Zurück von OpenID.
Der Client sendet code und state zurück zur API. Die API-Antwort enthält die Aufforderung der Zwei-Faktor-Authentifizierungs-Erweiterung an den Benutzer, den zweiten Faktor einzugeben.

Der Client fordert jetzt den Benutzer dazu auf, in der App für die Zwei-Faktor-Authentifizierung ein neues Konto aufzusetzen und den aktuellen Code einzugeben oder erlaubt dem Benutzer, die 2FA-Einrichtung zu überspringen. Lass uns annehmen, dass der Benutzer 2FA aufsetzt.

Vierter Schritt: Zwei-Faktor-Authentifizierung aufsetzen.
Die Kontenerstellung war erfolgreich.

Wenn die Kontenerstellung an irgendeinem Zeitpunkt scheitert, wird eine Antwort mit dem Status FAIL zurückgegeben und dem Benutzer wird eine message angezeigt.

Zusätzliche Anmerkungen

 * Kontenerstellungen werden in Special:log/newusers aufgezeichnet.

Wenn du angemeldet bist wird auch dein Benutzername bei der Kontenerstellung gespeichert.


 * Beachte beim Ausführen der Code-Ausschnitte auf dieser Seite:
 * Sobald ein Konto in einem Wiki erstellt wurde, kann es nicht gelöscht werden.
 * Nutze immer als Endpunkt, damit du nicht versehentlich Konten in echten Wikis erstellst.
 * MediaWiki-Seiten-Administratoren und Erweiterungsentwickler können diese API-Funktion durch das Einfügen folgender Zeile in die Konfigurationsdatei deaktivieren: