Ajuda da API do MediaWiki
Esta é uma página de documentação da API do 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 escrita.
- Este módulo só aceita pedidos POST.
- Fonte: MediaWiki
- Licença: GPL-2.0-or-later
Criar uma conta de utilizador nova.
O procedimento geral para usar este módulo é:
- Obtenha os campos disponíveis usando action=query&meta=authmanagerinfo com amirequestsfor=create e uma chave createaccount obtida de action=query&meta=tokens.
- Apresente os campos ao utilizador e obtenha os dados fornecidos por este.
- Publique-os para este módulo, fornecendo createreturnurl e quaisquer campos relevantes.
- Verifique o valor de status na resposta.
- Se recebeu PASS ou FAIL, terminou. A operação terá tido êxito ou falhado.
- Se recebeu UI, apresente os novos campos ao utilizador e obtenha os dados fornecidos por este. Depois publique-os para este módulo com createcontinue e os campos relevantes preenchidos, e repita o passo 4.
- Se recebeu REDIRECT, encaminhe o utilizador para redirecttarget e aguarde o retorno para o URL createreturnurl. Depois publique para este módulo com createcontinue quaisquer campos que tenham sido passados ao URL de retorno, e repita o passo 4.
- Se recebeu RESTART, isto significa que a autenticação funcionou mas não temos uma conta de utilizador associada. Pode dar-lhe o tratamento de UI ou FAIL.
- createrequests
Usar só estes pedidos de autenticação, com o id devolvido por action=query&meta=authmanagerinfo com amirequestsfor=create ou por uma resposta anterior deste módulo.
- Separar os valores com | ou alternativas.
- O número máximo de valores é 50 (500 para clientes a quem são permitidos limites mais elevados).
- createmessageformat
Formato a usar nas mensagens de saída.
- Um dos seguintes valores: html, none, raw, wikitext
- Valor por omissão: wikitext
- createmergerequestfields
Combinar a informação de todos os pedidos de autenticação numa única matriz.
- Tipo: booliano (detalhes)
- createpreservestate
Preservar o estado de uma tentativa de autenticação anterior falhada, se possível.
Se action=query&meta=authmanagerinfo devolveu o valor verdadeiro para hasprimarypreservedstate, pedidos marcados como primary-required devem ser omitidos. Se devolveu um valor não vazio em preservedusername, esse nome de utilizador tem de ser usado no parâmetro username.
- Tipo: booliano (detalhes)
- createreturnurl
O URL de retorno para processos de autenticação por terceiros tem de ser absoluto. É obrigatório fornecer este URL ou createcontinue.
Tipicamente, depois de receber uma resposta REDIRECT, abrirá um browser ou uma vista da Internet para o URL redirecttarget especificado, para dar lugar ao processo de autenticação por terceiros. Quando esse processo terminar, a terceira entidade encaminhará o browser ou a vista da Internet para este URL. Deve extrair do URL quaisquer parâmetros de consulta ou de POST, e passá-los como um pedido createcontinue a este módulo da API.
- createcontinue
Este pedido é uma continuação após uma resposta anterior com o valor UI ou REDIRECT. É obrigatório fornecer este parâmetro ou o parâmetro createreturnurl.
- Tipo: booliano (detalhes)
- createtoken
Uma chave "createaccount" obtida 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 os pedidos disponíveis e os campos que estes utilizam.
- Iniciar o processo de criação do utilizador Example com a palavra-passe ExamplePassword.
- api.php?action=createaccount&username=Example&password=ExamplePassword&retype=ExamplePassword&createreturnurl=http://example.org/&createtoken=123ABC [abrir na página de testes]