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+
Criar e editar páginas.
- title
Título da página para editar. Não pode ser usado em conjunto com pageid.
- pageid
ID da página para editar. Não pode ser usada juntamente com title.
- Tipo: inteiro
- section
Número da secção. 0 para a secção de topo, new para uma secção nova.
- sectiontitle
O título para uma nova seçã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
Edição menor.
- Tipo: booleano (detalhes)
- notminor
Edição não-menor.
- Tipo: booleano (detalhes)
- bot
Marcar esta edição como uma edição de bot.
- Tipo: booleano (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: booleano (detalhes)
- createonly
Não editar a página se já existir.
- Tipo: booleano (detalhes)
- nocreate
Mostra um erro se a página não existir.
- Tipo: booleano (detalhes)
- watch
- Obsoleto
Adiciona a página para a lista de vigiados do usuário atual.
- Tipo: booleano (detalhes)
- unwatch
- Obsoleto
Remove a página para a lista de vigiados do usuário atual.
- Tipo: booleano (detalhes)
- watchlist
Incondicionalmente adiciona ou página para a lista de vigiados do usuário atual, usa as preferências ou não modifica.
- 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.
- Tipo: inteiro
- undoafter
Desfazer todas as revisões desde undo até esta. Se não for definido, desfazer só uma revisão.
- Tipo: inteiro
- redirect
Resolver automaticamente redirecionamentos.
- Tipo: booleano (detalhes)
- contentformat
Formato de serialização de conteúdo usado para o texto de entrada.
- Um dos seguintes valores: text/x-wiki, text/javascript, application/json, text/css, text/plain
- contentmodel
Modelo de conteúdo do novo conteúdo.
- Um dos seguintes valores: wikitext, javascript, json, css, text, Scribunto
- 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.
- Edita 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]
- Antecende __NOTOC__ a 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]