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/API
action=edit
- Este módulo requer direitos de leitura.
- Este módulo requer direitos de escrita.
- Este módulo só aceita pedidos POST.
- Fonte: MediaWiki
- Licença: GPL-2.0-or-later
Criar e editar páginas.
- title
Título da página a ser editada. Não pode ser usado em conjunto com pageid.
- pageid
Identificador da página a ser editada. Não pode ser usado em conjunto com title.
- Tipo: inteiro
- section
Número da secção. 0 para a secção de topo, new para uma secção nova.
- sectiontitle
Título para uma nova secção.
- text
Conteúdo da página.
- summary
Resumo da edição. Também é o título da secção quando section=new e sectiontitle não está definido.
- tags
Etiquetas de modificação a aplicar à revisão.
- Valores (separados com | ou alternativas):
- minor
Marcar esta edição como menor.
- Tipo: booliano (detalhes)
- notminor
Não marcar esta edição como uma edição menor, mesmo se a preferência "Por omissão, marcar todas as edições como menores" do utilizador estiver definida.
- Tipo: booliano (detalhes)
- bot
Marcar esta edição como edição de robô.
- Tipo: booliano (detalhes)
- basetimestamp
Data e hora da revisão de base, usada para detetar conflitos de edição. Pode ser obtida usando action=query&prop=revisions&rvprop=timestamp.
- Tipo: data e hora (formatos permitidos)
- starttimestamp
Data e hora de início do processo de edição, usada para detetar conflitos de edição. Pode-se obter um valor apropriado usando curtimestamp ao iniciar o processo de edição (por exemplo, ao carregar o conteúdo da página para edição).
- Tipo: data e hora (formatos permitidos)
- recreate
Ignorar todos os erros acerca da página ter sido eliminada entretanto.
- Tipo: booliano (detalhes)
- createonly
Não editar a página se ela já existe.
- Tipo: booliano (detalhes)
- nocreate
Gerar um erro se a página não existe.
- Tipo: booliano (detalhes)
- watch
- Obsoleto.
Adicionar a página às páginas vigiadas do utilizador atual.
- Tipo: booliano (detalhes)
- unwatch
- Obsoleto.
Remover a página da lista de páginas vigiadas do utilizador atual.
- Tipo: booliano (detalhes)
- watchlist
Adicionar ou remover incondicionalmente a página da lista de páginas vigiadas do utilizador atual, usar as preferências ou não alterar o estado de vigilância.
- Um dos seguintes valores: watch, unwatch, preferences, nochange
- Valor por omissão: preferences
- md5
A chave MD5 do parâmetro text, ou os parâmetros prependtext e appendtext concatenados. Se estiver definido, a edição não será realizada a menos que a chave seja correta.
- prependtext
Adicionar este texto ao início da página. Tem precedência sobre text.
- appendtext
Adicionar este texto ao fim da página. Tem precedência sobre text.
Para acrescentar uma nova secção no fim da página, usar section=new em vez deste parâmetro.
- undo
Desfazer esta revisão. Tem precedência sobre text, prependtext e appendtext.
- O valor não pode ser inferior a 0.
- Tipo: inteiro
- undoafter
Desfazer todas as revisões desde undo até esta. Se não for definido, desfazer só uma revisão.
- O valor não pode ser inferior a 0.
- Tipo: inteiro
- redirect
Resolver automaticamente redirecionamentos.
- Tipo: booliano (detalhes)
- contentformat
Formato para seriação do conteúdo, usado para o texto de entrada.
- Um dos seguintes valores: application/json, text/x-wiki, text/javascript, text/css, text/plain
- contentmodel
Modelo de conteúdo do novo conteúdo.
- Um dos seguintes valores: GadgetDefinition, wikitext, javascript, json, css, text
- token
Uma chave "csrf" obtida de action=query&meta=tokens
A chave deve ser sempre enviada como último parâmetro, ou pelo menos após o parâmetro text.
- Este parâmetro é obrigatório.
- captchaword
Resposta ao CAPTCHA
- captchaid
Identificador CAPTCHA do pedido anterior
- Editar uma página.
- api.php?action=edit&title=Test&summary=test%20summary&text=article%20content&basetimestamp=2007-08-24T12:34:54Z&token=123ABC [abrir na página de testes]
- Acrescentar __NOTOC__ ao início de uma página.
- api.php?action=edit&title=Test&summary=NOTOC&minor=&prependtext=__NOTOC__%0A&basetimestamp=2007-08-24T12:34:54Z&token=123ABC [abrir na página de testes]
- Desfazer desde a revisão 13579 até à 13585 com resumo automático.
- api.php?action=edit&title=Test&undo=13585&undoafter=13579&basetimestamp=2007-08-24T12:34:54Z&token=123ABC [abrir na página de testes]