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=createaccount (create)
- 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
Crêa 'na nêuva uténsa.
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=create e 'n token createaccount 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 createreturnurl 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 createcontinue 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 createreturnurl. A quéllo moménto, ezegoî 'n post a sto mòdolo chi con createcontinue 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.
- createrequests
Dêuviâ sôlo ste domànde de outenticaçión chi, co-o id restitoîo da action=query&meta=authmanagerinfo con amirequestsfor=create ò '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).
- createmessageformat
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
- createmergerequestfields
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)
- createpreservestate
Conservâ o stâto da 'n precedénte tentatîvo de intrâ ch'o no l'é ariescîo, se poscìbile.
Se action=query&meta=authmanagerinfo o l'à restitoîo true pe hasprimarypreservedstate, e domànde contrasegnæ cómme primary-required doviéivan êse òmìsse. Se pe cóntra o l'à restitoîo 'n valô no vêuo pe preservedusername, quéllo nómme uténte o dêv'êse dêuviòu pe-o paràmetro username.
- Tîpoː boleàn (detàggi)
- createreturnurl
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 ò createcontinue 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 createcontinue a sto mòdolo API chi.
- createcontinue
Quésta domànda a l'é 'na continoaçión dòppo 'na precedénte rispòsta UI ò REDIRECT. Quésto ò createreturnurl o l'é necesâio.
- Tîpoː boleàn (detàggi)
- createtoken
'N token "createaccount" 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=create (ò '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æ.
- Inàndia o procèsso da creaçión de l'uténte Example con password ExamplePassword.
- api.php?action=createaccount&username=Example&password=ExamplePassword&retype=ExamplePassword&createreturnurl=http://example.org/&createtoken=123ABC [arvî inte 'na sandbox]