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=linkaccount (link)

(main | linkaccount)

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

Prepojiť účet od poskytovateľa tretej strany s aktuálnym používateľom.

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

Získajte dostupné polia z action=query&meta=authmanagerinfo s amirequestsfor=link a token csrf z action=query&meta=tokens.
Zobrazte polia používateľovi a získajte ich odoslanie.
Pošlite POST do tohto modulu so zadaním linkreturnurl 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 linkcontinue 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 linkreturnurl. Potom pošlite POST do tohto modulu s linkcontinue 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.

https://www.mediawiki.org/wiki/Special:MyLanguage/API:Linkaccount

Parametry:

K dispozícii sú aj ďalšie všeobecné parametre.

linkrequests

Použiť iba tieto autentifikačné požiadavky, podľa id vráteného z action=query&meta=authmanagerinfo s amirequestsfor=link 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).

linkmessageformat

Formát, ktorý sa má použiť na vracanie správ.

Jedna z následujících hodnot: html, none, raw, wikitext

Predvolené: wikitext

linkmergerequestfields

Zlúčiť informácie o poliach všetkých autentifikačných požiadaviek do jedného poľa.

Typ: logická hodnota (boolean) (podrobnosti)

linkreturnurl

Návratová URL pre autentifikačné postupy tretích strán, musí byť absolútna. Vyžaduje sa buď táto, alebo linkcontinue.

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 linkcontinue tomuto modulu API.

linkcontinue

Táto požiadavka je pokračovaním po skoršej odpovedi UI alebo REDIRECT. Vyžaduje sa buď táto, alebo linkreturnurl.

Typ: logická hodnota (boolean) (podrobnosti)

linktoken

Token typu „csrf“ 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=link (alebo prípadne predchádzajúcu odpoveď tohto modulu).

Příklad:

Začať proces prepájania s účtom od Example.: api.php?action=linkaccount&provider=Example&linkreturnurl=http://example.org/&linktoken=123ABC [otevřít v pískovišti]