Ajuda da API MediaWiki
Esta é uma página de documentação da API MediaWiki gerada automaticamente.
Documentação e exemplos: https://www.mediawiki.org/wiki/Special:MyLanguage/API:Main_page
action=createaccount (create)
- Este módulo requer direitos de gravação.
- Este módulo aceita apenas pedidos POST.
- Fonte: MediaWiki
- Licença: GPL-2.0-or-later
Criar uma nova conta de usuário.
O procedimento geral para usar este módulo é:
- Procure os campos disponíveis de action=query&meta=authmanagerinfo com amirequestsfor=create e um token createaccount de action=query&meta=tokens.
- Apresentar os campos para o usuário e obtenha a sua submissão.
- Poste em este módulo, fornecendo createreturnurl e quaisquer campos relevantes.
- Verifique o status na resposta.
- Se você recebeu PASS ou FAIL, você terminou. A operação foi bem sucedida ou não.
- Se você recebeu UI, apresente os novos campos ao usuário e obtenha seu envio. Em seguida, publique neste módulo com createcontinue e os campos relevantes sejam definidos e repita a etapa 4.
- Se você recebeu REDIRECT, direcione o usuário para o redirecttarget e aguarde o retorno para createreturnurl. Em seguida, publique neste módulo com createcontinue e quaisquer campos passados para o URL de retorno e repita a etapa 4.
- Se você recebeu RESTART, isso significa que a autenticação funcionou mas não temos uma conta de usuário vinculada. Você pode tratar isso como UI ou como FAIL.
- createrequests
Utilize apenas estes pedidos de autenticação, pelo id retornado de action=query&meta=authmanagerinfo com amirequestsfor=create ou de uma resposta anterior deste módulo.
- Valores separados com | ou alternativas.
- O número máximo de valores é 50 (500 para clientes aos quais limites mais altos são permetidos).
- createmessageformat
Formato a ser usado para retornar mensagens.
- Um dos seguintes valores: html, none, raw, wikitext
- Padrão: wikitext
- createmergerequestfields
Fundir informações de campo para todos os pedidos de autenticação em uma matriz.
- Tipo: booleano (detalhes)
- createpreservestate
Preserva o estado de uma tentativa de login anterior com falha, se possível.
Se action=query&meta=authmanagerinfo retornar true para hasprimarypreservedstate, pedidos marcados como hasprimarypreservedstate devem ser omitidos. Se retornou um valor não vazio para preservedusername, esse nome de usuário deve ser usado pelo parâmetro username.
- Tipo: booleano (detalhes)
- createreturnurl
O URL de retorno para fluxos de autenticação de terceiros deve ser absoluto. Isso ou createcontinue é necessário.
Quando receber uma resposta REDIRECT, você normalmente abrirá um navegador ou uma visão da web para o redirecttarget URL para um fluxo de autenticação de terceiros. Quando isso for concluído, o terceiro enviará ao navegador ou a web para este URL. Você deve extrair qualquer consulta ou parâmetros POST do URL e passá-los como uma solicitação createcontinue para este módulo de API.
- createcontinue
Esse pedido é uma continuação após uma resposta UI ou REDIRECT anterior. Ou createreturnurl é requerido.
- Tipo: booleano (detalhes)
- createtoken
Um token "createaccount" token recuperado de action=query&meta=tokens
- Este parâmetro é obrigatório.
- *
- Este módulo aceita parâmetros adicionais dependendo dos pedidos de autenticação disponíveis. Use action=query&meta=authmanagerinfo com amirequestsfor=create (ou uma resposta anterior deste módulo, se aplicável) para determinar as solicitações disponíveis e os campos que eles usam.
- Inicie o processo de criação do usuário Example com a senha ExamplePassword.
- api.php?action=createaccount&username=Example&password=ExamplePassword&retype=ExamplePassword&createreturnurl=http://example.org/&createtoken=123ABC [abrir na página de testes]