API:Account creation/hu



API-dokumentáció


Fiók létrehozása
A folyamatnak három alapvető lépése van:


 * 1) A  mezőinek és a  tokenjének kigyűjtése.
 * 2) POST-kérés küldése a megfelelő tokennel, felhasználói információkkal és más mezőkkel, és visszatérési URL-lel az API-nak.
 * 3) A válasz elbírálása, amely további POST-kéréseket igényelhet a további információkhoz.



1. példa: A folyamat egy speciális azonosító kiterjesztések nélküli wikin
Egy speciális azonosító kiterjesztések nélküli wiki elég egyértelmű lehet. Ha tudja a kódod, mely mezők kellenek, átugorhat a hívásban a -re, és egyszerűen feltételezheti, mely mezők szükségesek (azaz felhasználónév, jelszó és újraírt jelszó, e-mail-cím, esetleg valós név).



Válasz


Mintakód


2. példa: A folyamat egy CAPTCHA-kiterjesztéssel rendelkező wikin
Az alábbi első lépés, ha szeretnéd, két lépésben is megtehető: egy az elérhető mezők kigyűjtése a -ből, egy másik a token kigyűjtése a -ből.



Első lépés: Az elérhető mezők kigyűjtése az -ből és a token kigyűjtése a -ből


Második lépés: POST-kérés küldése egy fióklétrehozó tokennel, felhasználói információkkal és visszatérési URL-lel


Mintakód
Ez a kódminta elválasztja a és  kéréseket, és általánosságban feltételezi, hogy van CAPTCHA, és nincs más komplikáció.



3. példa: Fióklétrehozás engedélyezett CAPTCHA-val, OpenID- és kétfaktoros azonosítást lehetővé tevő kiterjesztéssel


Első lépés: Az elérhető mezők kigyűjtése az -ből és a token kigyűjtése a -ből
A kigyűjtés a -ből és a -ből nagyjából ugyanaz, mint az előző példában, ezért nincs itt megismételve. A által visszakapott kérések listája tartalmazza a definíciókat a CAPTCHA- és az OpenID-kiterjesztésre is.

Második lépés: a CAPTCHA megválaszolása és az OpenID-azonosítás kiválasztása.
A kliens a felhasználó böngészőjét várhatóan a megadott redirecttarget re irányítja át.

Az OpenID-biztosító azonosít, és átirányít a wiki Speciális:OpenIDConnectReturn oldalára, amely érvényesíti az OpenID-választ, és átirányít az API-nak küldött első POST-kérésben szereplő, a code és state paraméterekkel kiegészített createreturnurl -re.

A kliens visszakapja a folyamat irányítását e ponton, és létrehozza a következő API-kérését.

Harmadik lépés: Vissza az OpenID-ből.
A kliens visszaküldi a code és state változókat az API-hoz. Az API válasza a kétfaktoros azonosítást lehetővé tevő kiterjesztéssel megkéri a felhasználót a második faktor felállítására.

Ekkor a kliens a felhasználót új fiók létrehozására és a jelenlegi kód megadására kéri a kétfaktoros bejelentkezéshez használt alkalmazásában, vagy lehetővé teszi a kétfaktoros bejelentkezés felállításának kihagyását. Tegyük fel, hogy a felhasználó 2FA-t használ.

Negyedik lépés: a kétfaktoros azonosítás engedélyezése.
A fióklétrehozás sikerült.

Ha bármely ponton a fióklétrehozás sikertelen, egy FAIL állapotú válasz érkezik vissza egy, a felhasználónak megmutatott message -dzsel.



Lehetséges hibák


További megjegyzések

 * A fióklétrehozásokat a Special:log/newusers tartalmazza.

Ha be vagy jelentkezve, a felhasználóneved fel lesz jegyezve a fiók létrehozásakor.


 * Az itt látható kódrészletek végrehajtásakor ne felejtsd el:
 * Ha egy fiók létrejön egy wikin, nem törölhető.
 * Mindig használd a -t végpontként, hogy ne hozz létre véletlenül fiókokat valódi wikiken.
 * A MediaWiki oldaladminisztrátorai és kiterjesztésfejlesztői letilthatják ezt az API-funkciót az alábbi sor beillesztésével a konfigurációs fájlba:

