Pomoč za API MediaWiki
To je samodejno ustvarjena stran za API MediaWiki.
Dokumentacija in zgledi: https://www.mediawiki.org/wiki/Special:MyLanguage/API:Main_page
action=createaccount (create)
- Ta modul zahteva pravice pisanja.
- Ta modul sprejema samo zahtevke POST.
- Vir: MediaWiki
- Licenca: GPL-2.0-or-later
Ustvaritev novega uporabniškega računa.
Splošni postopek za uporabo tega modula je:
- Pridobite polja, ki so na voljo iz action=query&meta=authmanagerinfo z amirequestsfor= create in žeton createaccount iz action=query&meta=tokens .
- Predstavite polja uporabniku in pridobite njegov odgovor.
- Objavite v tem modulu z navedbo createreturnurl in vseh ustreznih polj.
- Preverite status v odgovoru.
- Če ste prejeli PASS ali FAIL, ste končali. Operacija je bila bodisi uspešna bodisi ne.
- Če ste prejeli UI, predstavite nova polja uporabniku in pridobite njegov odgovor. Nato objavite v tem modulu z createcontinue in nastavljenimi ustreznimi polji ter ponovite 4. korak.
- Če ste prejeli REDIRECT, usmerite uporabnika na cilj v polju reddirecttargtet in počakajte na vrnitev na createreturnurl. Nato objavite v tem modulu z createcontinue in vsemi polji, posredovanimi povratnemu URL-ju, ter ponovite 4. korak.
- Če ste prejeli RESTART, to pomeni, da je preverjanje pristnosti delovalo, vendar nimamo povezanega uporabniškega računa. To lahko obravnavate kot UI ali kot FAIL.
- createrequests
Uporabite samo te zahtevke za avtentikacijo z id, ki ga vrne action=query&meta=authmanagerinfo z amirequestsfor= create ali iz prejšnjega odgovora tega modula.
- Loči vrednosti z | ali alternative.
- Največje število vrednosti je 50 (500 za odjemalce z večjimi dovoljenimi omejitvami)
- createmessageformat
Oblikovanje za uporabo vrnjenih sporočl.
- Ena od naslednjih vrednosti: html, none, raw, wikitext
- Privzeto: wikitext
- createmergerequestfields
Združitev informacij o poljih za vse avtentikacijske zahtevke v eno matriko.
- Tip: Boolov (podrobnosti)
- createpreservestate
Če je mogoče, ohrani stanje prejšnjega neuspešnega poskusa prijave.
Če je action=query&meta=authmanagerinfo za hasprimarypreservedstate vrnil true, je treba zahtevke, označene kot hasprimarypreservedstate, izpustiti. Če je za reservedusername vrnil neprazno vrednost, je treba to uporabniško ime uporabiti za parameter username.
- Tip: Boolov (podrobnosti)
- createreturnurl
URL za povratno povezavo za poteke avtentikacije tretjih oseb mora biti absoluten. Zahtevan je bodisi ta bodisi createcontinue .
Ko prejmete odgovor REDIRECT, boste običajno odprli brskalniški ali spletni pogled na določen URL redirecttarget za potek avtentikacije tretje osebe. Ko se to zaključi, bo tretja oseba poslala brskalniški ali spletni pogled na ta URL. Iz URL-ja morate izvleči vse parametre poizvedbe ali POST in jih kot zahtevek createcontinue posredovati temu API-modulu.
- createcontinue
Ta zahtevek je nadaljevanje prejšnjega odgovora UI/samp> ali REDIRECT. Zahtevan je bodisi ta bodisi createreturnurl.
- Tip: Boolov (podrobnosti)
- createtoken
Žeton »createaccount« pridobljen iz action=query&meta=tokens
- Ta parameter je obvezen.
- *
- Ta modul sprejema dodatne parametre, odvisno od razpoložljivih zahtevkov za avtentikacijo. Za določitev razpoložljivih zahtevkov in polj, ki jih uporabljajo, uporabite action=query&meta=authmanagerinfo z amirequestsfor= create (ali prejšnjim odgovorom iz tega modula, če je primerno).
- Začetek postopka ustvarjanja uporabnika Example z geslom ExamplePassword.
- api.php?action=createaccount&username=Example&password=ExamplePassword&retype=ExamplePassword&createreturnurl=http://example.org/&createtoken=123ABC [odpri v peskovniku]