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

(main | linkaccount)
  • Denne modulen krever skrivetilgang.
  • Denne modulen aksepterer bare POST forespørsler.
  • Kilde: MediaWiki
  • Lisens: GPL-2.0-or-later

Lenk en konto fra en tredjepartsleverandør til den gjeldende brukeren.

Den generelle prosedyren for å bruke denne modulen er:

  1. Hent feltene som er tilgjengelige fra action=query&meta=authmanagerinfo med amirequestsfor=link og en csrf-nøkkel fra action=query&meta=tokens.
  2. Presenter feltene til brukeren og få tak i dennes innlevering.
  3. Post til denne modulen med linkreturnurl og relevante felter.
  4. 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 linkcontinue og de relevante feltene satt, og gjenta steg 4.
    • Hvis du mottok REDIRECT, omdiriger brukeren til redirecttarget og vent på returen til linkreturnurl. Post så til denne modulen med linkcontinue 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.
Spesifikke parametre:
Andre generelle parametre er tilgjengelige.
linkrequests

Bruk bare disse autentiseringsforespørslene, av id-en returnert fra action=query&meta=authmanagerinfo med amirequestsfor=link 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).
linkmessageformat

Format å bruke for returnering av beskjeder.

Én av følgende verdier: html, none, raw, wikitext
Standard: wikitext
linkmergerequestfields

Slå sammen feltinformasjon for alle autentiseringsforespørsler til én tabell.

Type: boolsk (detaljer)
linkreturnurl

Returnerings-URL for tredjeparts autentiseringsflyter, må være absolutt. Enten denne eller linkcontinue 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 linkcontinue-forespørsler til denne API-modulen.

linkcontinue

Denne forespørselen er en fortsettelse etter en tidligere UI- eller REDIRECT-respons. Enten denne eller linkreturnurl er påkrevd.

Type: boolsk (detaljer)
linktoken

En «csrf»-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=link (eller en tidligere respons fra denne modulen, hvis det gjelder) for å bestemme hvilke forespørsler som er tilgjengelige og feltene de bruker.