MediaWiki-API-hjelp
Dette er en automatisk generert MediaWiki-API-dokumentasjonsside.
Dokumentasjon og eksempler: https://www.mediawiki.org/wiki/Special:MyLanguage/API:Main_page
action=createaccount (create)
- Denne modulen krever skrivetilgang.
- Denne modulen aksepterer bare POST forespørsler.
- Kilde: MediaWiki
- Lisens: GPL-2.0-or-later
Opprett en ny brukerkonto.
Den generelle prosedyren for å bruke denne modulen er:
- Hent feltene som er tilgjengelige fra action=query&meta=authmanagerinfo med amirequestsfor=create og en createaccount-nøkkel fra action=query&meta=tokens.
- Presenter feltene til brukeren og få tak i dennes innlevering.
- Post til denne modulen med createreturnurl og relevante felter.
- Sjekk status i responsen.
- Hvis du mottok PASS eller FAIL er du ferdig. Operasjonen lyktes eller mislyktes.
- Hvis du mottok UI, presenter de nye feltene til brukeren og få tak i dennes innlevering. Post så til denne modulen med createcontinue og de relevante feltene satt, og gjenta steg 4.
- Hvis du mottok REDIRECT, omdiriger brukeren til redirecttarget og vent på returen til createreturnurl. Post så til denne modulen med createcontinue og felter sendt til returnerings-URL-en, og gjenta steg 4.
- Hvis du mottok RESTART betyr det at autentiseringen virket, men vi ikke har en lenket brukerkonto. Du kan velge å behandle dette som UI eller som FAIL.
- createrequests
Bruk bare disse autentiseringsforespørslene, av id-en returnert fra action=query&meta=authmanagerinfo med amirequestsfor=create eller fra en tidligere respons fra denne modulen.
- Separer verdier med | eller alternativ.
- Maksimalt antall verdier er 50 (500 for klienter som er tillatt høyere grenser).
- createmessageformat
Format å bruke for returnering av beskjeder.
- Én av følgende verdier: html, none, raw, wikitext
- Standard: wikitext
- createmergerequestfields
Slå sammen feltinformasjon for alle autentiseringsforespørsler til én tabell.
- Type: boolsk (detaljer)
- createpreservestate
Bevar statusen fra et tidligere mislykket innloggingsforsøk hvis det er mulig.
Om action=query&meta=authmanagerinfo returnerte true for hashprimarypreservedstate bør forespørsler merket som primary-required omgås. Om den returnerte en ikke-tom verdi for preservedusername kan det brukernavnet brukes for username-parameteren.
- Type: boolsk (detaljer)
- createreturnurl
Returnerings-URL for tredjeparts autentiseringsflyter, må være absolutt. Enten denne eller createcontinue kreves.
Når du mottar en REDIRECT-respons vil du typisk åpne en nettleser eller nettvisning til den angitte redirecttarget-URL-en for en tredjeparts autentiseringsflyt. Når den fullføres vil tredjeparten sende nettleseren eller nettvisningen til denne URL-en. Du bør trekke ut spørrings- eller POST-parametre fra URL-en og sende dem som createcontinue-forespørsler til denne API-modulen.
- createcontinue
Denne forespørselen er en fortsettelse etter en tidligere UI- eller REDIRECT-respons. Enten denne eller createreturnurl er påkrevd.
- Type: boolsk (detaljer)
- createtoken
En «createaccount»-nøkkel hentet fra action=query&meta=tokens
- Denne parameteren er påkrevd.
- *
- Denne modulen godtar ekstra parametre avhengig av de tilgjengelige autentiseringsforespørslene. Bruk action=query&meta=authmanagerinfo med amirquestsfor=create (eller en tidligere respons fra denne modulen, hvis det gjelder) for å bestemme hvilke forespørsler som er tilgjengelige og feltene de bruker.
- Start prosessen med å opprette brukeren Example med passordet ExamplePassword.
- api.php?action=createaccount&username=Example&password=ExamplePassword&retype=ExamplePassword&createreturnurl=http://example.org/&createtoken=123ABC [åpne i sandkasse]