Nápověda k MediaWiki API
Toto je automaticky generovaná dokumentační stránka k MediaWiki API.
Dokumentace a příklady: https://www.mediawiki.org/wiki/Special:MyLanguage/API:Main_page
action=createaccount (create)
- Tento modul vyžaduje oprávnění k zápisu.
- Tento modul přijímá pouze požadavky POST.
- Zdroj: MediaWiki
- Licence: GPL-2.0-or-later
Vytvořit nový uživatelský účet.
Všeobecný postup použitia tohto modulu je:
- Získajte dostupné polia z action=query&meta=authmanagerinfo s amirequestsfor=create a token createaccount z action=query&meta=tokens.
- Zobrazte polia používateľovi a získajte ich odoslanie.
- Pošlite POST do tohto modulu so zadaním createreturnurl a všetkých relevantných polí.
- Skontrolujte status v odpovedi.
- Ak ste dostali PASS alebo FAIL, ste hotoví. Operácia buď uspela, alebo nie.
- Ak ste dostali UI, zobrazte nové polia používateľovi a získajte ich odoslanie. Potom pošlite POST do tohto modulu s createcontinue a nastavenými relevantnými poľami a opakujte krok 4.
- Ak ste dostali REDIRECT, presmerujte používateľa na redirecttarget a počkajte na návrat na createreturnurl. Potom pošlite POST do tohto modulu s createcontinue a všetkými poľami odovzdanými návratovej URL a opakujte krok 4.
- Ak ste dostali RESTART, znamená to, že autentifikácia fungovala, ale nemáme prepojený používateľský účet. Môžete to považovať za UI alebo za FAIL.
- createrequests
Použiť iba tieto autentifikačné požiadavky, podľa id vráteného z action=query&meta=authmanagerinfo s amirequestsfor=create alebo z predchádzajúcej odpovede tohto modulu.
- Hodnoty oddělujte pomocí | nebo alternativou.
- Maximálny počet hodnôt je 50 (500 pre klientov s povolenými vyššími limitmi).
- createmessageformat
Formát, ktorý sa má použiť na vracanie správ.
- Jedna z následujících hodnot: html, none, raw, wikitext
- Predvolené: wikitext
- createmergerequestfields
Zlúčiť informácie o poliach všetkých autentifikačných požiadaviek do jedného poľa.
- Typ: logická hodnota (boolean) (podrobnosti)
- createpreservestate
Zachovať stav z predchádzajúceho neúspešného pokusu o prihlásenie, ak je to možné.
Ak action=query&meta=authmanagerinfo vrátilo true pre hasprimarypreservedstate, požiadavky označené ako primary-required by sa mali vynechať. Ak vrátilo neprázdnu hodnotu pre preservedusername, toto používateľské meno sa musí použiť v parametri username.
- Typ: logická hodnota (boolean) (podrobnosti)
- createreturnurl
Návratová URL pre autentifikačné postupy tretích strán, musí byť absolútna. Vyžaduje sa buď táto, alebo createcontinue.
Po prijatí odpovede REDIRECT zvyčajne otvoríte prehliadač alebo webové zobrazenie na zadanej URL redirecttarget pre autentifikačný postup tretej strany. Po jeho dokončení tretia strana pošle prehliadač alebo webové zobrazenie na túto URL. Mali by ste z URL extrahovať všetky parametre dotazu alebo POST a odovzdať ich ako požiadavku createcontinue tomuto modulu API.
- createcontinue
Táto požiadavka je pokračovaním po skoršej odpovedi UI alebo REDIRECT. Vyžaduje sa buď táto, alebo createreturnurl.
- Typ: logická hodnota (boolean) (podrobnosti)
- createtoken
Token typu „createaccount“ získaný pomocí action=query&meta=tokens.
- Tento parameter je povinný.
- *
- Tento modul prijíma dodatočné parametre v závislosti od dostupných autentifikačných požiadaviek. Na zistenie dostupných požiadaviek a polí, ktoré používajú, použite action=query&meta=authmanagerinfo s amirequestsfor=create (alebo prípadne predchádzajúcu odpoveď tohto modulu).
- Začať proces vytvárania používateľa Example s heslom ExamplePassword.
- api.php?action=createaccount&username=Example&password=ExamplePassword&retype=ExamplePassword&createreturnurl=http://example.org/&createtoken=123ABC [otevřít v pískovišti]