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=createaccount (create)
- Este módulo precisa permisos de escritura.
- Este módulo só acepta peticións POST.
- Fonte: MediaWiki
- Licenza: GPL-2.0-or-later
Crear unha nova conta de usuario.
O procedemento xeral para usar este módulo é:
action=query&meta=authmanagerinfo con amirequestsfor=create, e un identificador createaccount de action=query&meta=tokens.
- Presentar os campos ó usuario, e obter o seu envío.
- Enviar a este módulo, proporcionando createreturnurl 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 createcontinue e o conxunto de campos relevantes, e repite o paso 4.
- Se vostede recibe REDIRECT, dirixe ó usuario a redirecttarget e espera pola resposta a createreturnurl. Logo envíaa a este módulo con createcontinue 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.
- createrequests
Só usar estas peticións de autenticación, co id devolto por action=query&meta=authmanagerinfo con amirequestsfor=create 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).
- createmessageformat
Formato a usar para devolver as mensaxes.
- Un valor dos seguintes valores: html, none, raw, wikitext
- Valor por omissão: wikitext
- createmergerequestfields
Fusionar os campos de información para todas as peticións de autenticación nunha táboa.
- Tipo: booliano (detalhes)
- createpreservestate
Conservar o estado dun intento previo de conexión fallida, se é posible.
SE action=query&meta=authmanagerinfo devolve o valor "certo" para hasprimarypreservedstate, as consultas marcadas como primary-required deben ser omitidas. Se devolve un valor non baleiro para preservedusername, ese nome de usuario debe usarse para o parámetro username.
- Tipo: booliano (detalhes)
- createreturnurl
Devolve o URL para os fluxos de autenticación de terceiros, que debe ser absoluto. Este ou createcontinue é 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 createcontinue a este módulo API.
- createcontinue
Esta petición é unha continucación despois dun resposta precedente UI ou REDIRECT. Esta ou createreturnurl é requirida.
- Tipo: booliano (detalhes)
- createtoken
Un identificador "createaccount" 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=create (ou unha resposta previa deste módulo, se aplicable) para determinar as consultas dispoñibles e os campos que usan.
- Comezar o proceso de crear un usuario Exemplo con contrasinal ExemploContrasinal.
- api.php?action=createaccount&username=Example&password=ExamplePassword&retype=ExamplePassword&createreturnurl=http://example.org/&createtoken=123ABC [abrir en zona de probas]