Axuda da API de MediaWiki
Esta é unha páxina de documentación da API de MediaWiki xerada automaticamente.
Documentación e exemplos: https://www.mediawiki.org/wiki/API
action=linkaccount (link)
- Este módulo precisa permisos de escritura.
- Este módulo só acepta peticións POST.
- Fonte: MediaWiki
- Licenza: GPL-2.0-or-later
Vincular unha conta dun provedor externo ó usuario actual.
O procedemento xeral para usar este módulo é:
action=query&meta=authmanagerinfo con amirequestsfor=link, e un identificador csrf de action=query&meta=tokens.
- Presentar os campos ó usuario, e obter o seu envío.
- Enviar a este módulo, proporcionando linkreturnurl e calquera campo relevante.
- Comprobar o status na resposta.
- Se vostede recibe PASS ou FAIL, a acción rematou. A operación foi correcta ou non se fixo.
- Se vostede recibe UI, presenta os novos campos ó usuario e obtén o seu envío. Logo son enviados a este módulo con linkcontinue e o conxunto de campos relevantes, e repite o paso 4.
- Se vostede recibe REDIRECT, dirixe ó usuario a redirecttarget e espera pola resposta a linkreturnurl. Logo envíaa a este módulo con linkcontinue e calquera campo pasado á URL de volta, e repite o paso 4.
- Se recibe RESTART, isto significa que a autenticación funcionou pero que non temos unha conta de usuario ligada. Debe tratar isto igual que UI ou como FAIL.
- linkrequests
Só usar estas peticións de autenticación, co id devolto por action=query&meta=authmanagerinfo con amirequestsfor=link ou dunha resposta previa deste módulo.
- Separe os valores con | ou outros.
- O número máximo de valores é 50 (500 para clientes a quem são permitidos limites mais elevados).
- linkmessageformat
Formato a usar para devolver as mensaxes.
- Un valor dos seguintes valores: html, none, raw, wikitext
- Valor por omissão: wikitext
- linkmergerequestfields
Fusionar os campos de información para todas as peticións de autenticación nunha táboa.
- Tipo: booliano (detalhes)
- linkreturnurl
Devolve o URL para os fluxos de autenticación de terceiros, que debe ser absoluto. Este ou linkcontinue é obrigatorio.
Logo da recepción dunha resposta REDIRECT, vostede normalmente abrirá un navegador web ou un visor web para ver a URL redirecttarget especificada para un fluxo de autenticación de terceiros. Cando isto se complete, a aplicación de terceiros enviará ó navegador web ou visor web a esta URL. Vostede debe eliminar calquera consulta ou parámetros POST da URL e pasalos como unha consulta linkcontinue a este módulo API.
- linkcontinue
Esta petición é unha continucación despois dun resposta precedente UI ou REDIRECT. Esta ou linkreturnurl é requirida.
- Tipo: booliano (detalhes)
- linktoken
Un identificador "csrf" recuperado por action=query&meta=tokens
- Este parâmetro é obrigatório.
- *
- Este módulo acepta parámetros adicionais dependendo das consultas de autenticación dispoñibles. Use action=query&meta=authmanagerinfo con amirequestsfor=link (ou unha resposta previa deste módulo, se aplicable) para determinar as consultas dispoñibles e os campos que usan.
- Comezar o proceso de vincular a unha conta de Exemplo.
- api.php?action=linkaccount&provider=Example&linkreturnurl=http://example.org/&linktoken=123ABC [abrir en zona de probas]