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=edit

(main | 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.

Parâmetros:
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 "Marcar todas as edições como secundárias, por padrão" do utilizador estiver definida.

Tipo: booliano (detalhes)
bot

Marcar esta edição como edição de robô.

Tipo: booliano (detalhes)
baserevid

Identificador da revisão base, usado para detetar conflitos de edições. Pode ser obtido através de action=query&prop=revisions. Autoconflitos causam a falha da edição a menos que esteja definido o parâmetro basetimestamp.

Tipo: inteiro
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. Os autoconflitos serão ignorados.

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: nochange, preferences, unwatch, watch
Padrã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
O valor não pode ser inferior a 0.
undoafter

Desfazer todas as revisões desde undo até esta. Se não for definido, desfazer só uma revisão.

Tipo: inteiro
O valor não pode ser inferior a 0.
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/css, text/javascript, text/plain, text/x-wiki
contentmodel

Modelo de conteúdo do novo conteúdo.

Um dos seguintes valores: css, javascript, json, text, wikitext
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.