Agiùtto dAPI MediaWiki

Sta chi a l'é 'na pàgina de docomentaçión de API MediaWiki outogenerâ.

Docomentaçión e ezénpiː https://www.mediawiki.org/wiki/Special:MyLanguage/API:Main_page

action=linkaccount (link)

(main | linkaccount)

Sto mòdolo chi o domànda i dirìtti de scritûa.
Sto mòdolo chi o l'achéugge sôlo domànde POST.
Referénsaː MediaWiki
Licénsaː GPL-2.0-or-later

Colegaménto de 'n'uténsa de 'n provider de tèrse pàrte a l'uténte corénte.

A procedûa generâle pe dêuviâ sto mòdolo chi a l'é:

Òtegnî i cànpi disponìbili da action=query&meta=authmanagerinfo con amirequestsfor=link e 'n token csrf da action=query&meta=tokens.
Mostrâ i cànpi a l'uténte e òtegnî i dæti ch'o mànda.
Ezegoî 'n post a sto mòdolo chi, fornìndo linkreturnurl e ògni cànpo rilevànte.
Controlâ status inta risposta.
- Se ti t'æ riçevûo PASS ò FAIL, ti t'æ finîo. Into prìmmo câzo l'òperaçión a l'é finî bén, into segóndo no.
- Se ti t'æ riçevûo UI, o móstra i nêuvi cànpi a l'uténte e s'òtêgne i dæti ch'o mànda. Ezegoî 'n post a sto mòdolo chì con linkcontinue e i cànpi rilevànti inpostæ, dónca ripête o pónto 4.
- Se ti t'æ riçevûo REDIRECT, mandâ l'uténte a redirecttarget e aspetâ ch'o tórne linkreturnurl. A quéllo moménto, ezegoî 'n post a sto mòdolo chi con linkcontinue e ògni cànpo pasòu a l'URL de ritórno, e ripête o pónto 4.
- Se ti t'æ riçevûo RESTART, vêu dî che l'outenticaçión a l'à fonçionòu ma no émmo 'n'uténza conligâ. Ti poriêsci consciderâ quésto câxo cómme UI ò cómme FAIL.

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

Paràmetri specìfichi:

Gh'é di âtri paràmetri generâli a dispoxiçión.

linkrequests

Dêuviâ sôlo ste domànde de outenticaçión chi, co-o id restitoîo da action=query&meta=authmanagerinfo con amirequestsfor=link ò 'na rispòsta precedénte da sto mòdolo chi.

Separâ i valoî con | ò alternatîva.

Maximum number of values is 50 (500 for clients that are allowed higher limits).

linkmessageformat

Formâto da dêuviâ pe-a restituçión di mesàggi.

Un di valoî chi de sótta: html, none, raw, wikitext

Predefinito: wikitext

linkmergerequestfields

Unî e informaçioìn di cànpi pe tùtte e domànde de outenticaçión inte 'n ùnico array.

Tîpoː boleàn (detàggi)

linkreturnurl

URL di ritórno pe-i flùssi di outenticaçión de tèrse pàrte, o dêv'êse asolûto. Quésto ò linkcontinue o l'é necesâio.

A-o riceviménto de 'na rispòsta REDIRECT, de sòlito s'àrve 'n browser ò 'na vìsta web a l'URL redirecttarget specificòu pe 'n flùsso de outenticaçión de tèrse pàrte. Quàndo quésto o l'é conpletòu, a tèrsa pàrte a mandiâ o browser ò a vìsta web a st'URL chi. Ti ti doviêsci pigiâ quæ se sæ paràmetro POST ò da domànda da l'URL e pasâli cómme 'na domànda linkcontinue a sto mòdolo API chi.

linkcontinue

Quésta domànda a l'é 'na continoaçión dòppo 'na precedénte rispòsta UI ò REDIRECT. Quésto ò linkreturnurl o l'é necesâio.

Tîpoː boleàn (detàggi)

linktoken

'N token "csrf" ricuperòu da action=query&meta=tokens

Questo parametro è obbligatorio.

*

Quésto mòdolo o l'acétta paràmetri de ciù in sciâ bâze de domànde de outenticaçión disponìbili. Dêuviâ action=query&meta=authmanagerinfo with amirequestsfor=link (ò 'na rispòsta ci̟ù vêgia da sto mòdolo chi, se disponìbile) pe determinâ e domànde disponìbili e i cànpi da quéste dêuviæ.

Ezénpio:

Inàndia o procèsso d'ingàncio a 'n'uténsa da Example.: api.php?action=linkaccount&provider=Example&linkreturnurl=http://example.org/&linktoken=123ABC [arvî inte 'na sandbox]