Adjuta sur le API de MediaWiki

Iste es un pagina de documentation generate automaticamente sur le API de MediaWiki.

Documentation e exemplos: https://www.mediawiki.org/wiki/Special:MyLanguage/API:Main_page

action=linkaccount (link)

(main | linkaccount)
  • Iste modulo require derectos de scriptura.
  • Iste modulo accepta solmente le requestas POST.
  • Fonte: MediaWiki
  • Licentia: GPL-2.0-or-later

Ligar un conto de un fornitor tertie al usator actual.

Le procedura general pro usar iste modulo es:

  1. Recuperar le campos disponibile de action=query&meta=authmanagerinfo con amirequestsfor=link, e un token csrf de action=query&meta=tokens.
  2. Presentar le campos al usator, e obtener lor submission.
  3. Inviar a iste modulo, forniente linkreturnurl e qualcunque campos relevante.
  4. Verificar le status (stato) in le responsa.
    • Si tu recipeva PASS o FAIL, tu es finite. Le operation ha succedite o fallite.
    • Si tu recipeva UI, presenta le nove campos al usator e obtene lor submission. Postea invia a iste modulo con linkcontinue e le campos relevante definite, e repete le passo 4.
    • Si tu recipeva REDIRECT, dirige le usator al redirecttarget (destination del redirection) e attende le retorno a linkreturnurl. Postea invia a iste modulo con linkcontinue e qualcunque campos passate al URL de retorno, e repete le passo 4.
    • Si tu recipeva RESTART, isto significa que le authentication functionava ma nos non ha un conto de usator ligate. Tu poterea tractar isto como UI o como FAIL.
Parametros specific:
Altere parametros general es disponibile.
linkrequests

Usar solmente iste requestas de authentication per le id restituite ab action=query&meta=authmanagerinfo con amirequestsfor=link o ab un responsa anterior de iste modulo.

Separar valores con | o un alternativa.
Le numero maxime de valores es 50 (500 pro clientes al quales ha essite permittite limites plus alte).
linkmessageformat

Formato a usar pro restituer messages.

Un del sequente valores: html, none, raw, wikitext
Predefinite: wikitext
linkmergerequestfields

Fusionar le information de campo pro tote le requestas de authentication in un sol matrice.

Typo: booleano (detalios)
linkreturnurl

URL de retorno pro fluxos de authentication de tertie parte, debe esser absolute. O iste o linkcontinue es obligatori.

Quando se recipe un responsa REDIRECT, on normalmente aperira un navigator o vista web al URL redirecttarget specificate pro un fluxo de authentication de tertie parte. Quando illo termina, le tertie parte inviara le navigator o vista web a iste URL. Tu debe extraher tote parametros de requesta o POST del URL e passar los como un requesta linkcontinue a iste modulo API.

linkcontinue

Iste requesta es un continuation post un responsa anterior de UI o REDIRECT. O iste o linkreturnurl es obligatori.

Typo: booleano (detalios)
linktoken

Un token "csrf" recuperate ab action=query&meta=tokens

Iste parametro es obligatori.
*
Iste modulo accepta parametros additional dependente del requestas de authentication disponibile. Usa action=query&meta=authmanagerinfo con amirequestsfor=link (o un responsa anterior ab iste modulo, si applicabile) pro determinar le requestas disponibile e le campos que illos usa.
Exemplo:
Initiar le processo de ligar a un conto desde Example.
api.php?action=linkaccount&provider=Example&linkreturnurl=http://example.org/&linktoken=123ABC [aperir in sabliera]
Obtenite de “https://ia.wiki.beta.math.wmflabs.org/wiki/Special:ApiHelp”