Pomocník API MediaWiki

Toto je automaticky generovaná dokumentačná stránka MediaWiki Action API.

action=createaccount (create)

(main | createaccount)
  • Tento modul vyžaduje práva na zápis.
  • Tento modul prijíma iba požiadavky POST.
  • Zdroj: MediaWiki
  • Licencia: GPL-2.0-or-later

Vytvoriť nový používateľský účet.

Všeobecný postup použitia tohto modulu je:

  1. Získajte dostupné polia z action=query&meta=authmanagerinfo s amirequestsfor=create a token createaccount z action=query&meta=tokens.
  2. Zobrazte polia používateľovi a získajte ich odoslanie.
  3. Pošlite POST do tohto modulu so zadaním createreturnurl a všetkých relevantných polí.
  4. 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.
Konkrétne parametre:
K dispozícii sú aj ďalšie všeobecné parametre.
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 oddeľte pomocou | alebo alternatívy.
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 nasledujúcich hodnôt: 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 „createaccount“ získaný z 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).