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=clientlogin (login)

(main | clientlogin)

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

Ìntra inta wiki dêuviàndo o flùsso interatîvo.

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=login e 'n token login 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 loginreturnurl 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 logincontinue 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 loginreturnurl. A quéllo moménto, ezegoî 'n post a sto mòdolo chi con logincontinue 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:Login

Paràmetri specìfichi:

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

loginrequests

Dêuviâ sôlo ste domànde de outenticaçión chi, co-o id restitoîo da action=query&meta=authmanagerinfo con amirequestsfor=login ò '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).

loginmessageformat

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

loginmergerequestfields

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)

loginpreservestate

Conservâ o stâto da 'n precedénte tentatîvo de intrâ ch'o no l'é ariescîo, se poscìbile.

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

loginreturnurl

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 ò logincontinue 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 logincontinue a sto mòdolo API chi.

logincontinue

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

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

logintoken

'N token "login" 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=login (ò '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énpi:

Inàndia o procèsso d'intrâ inta wiki cómme uténte Example con password ExamplePassword.: api.php?action=clientlogin&username=Example&password=ExamplePassword&loginreturnurl=http://example.org/&logintoken=123ABC [arvî inte 'na sandbox]
Contìnoa l'intrâ depoî 'na rispòsta de l'UI pe l'aotenticaçión a doî fatoî, fornìndo 'n OATHToken de 987654.: api.php?action=clientlogin&logincontinue=1&OATHToken=987654&logintoken=123ABC [arvî inte 'na sandbox]