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 específicos:
Estão disponíveis outros parâmetros gerais.
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

Identificador da secção. 0 para a secção de topo, new para uma secção nova. Normalmente é um inteiro positivo mas também pode não ser numérico.

sectiontitle

O título de uma secção nova quando é usado section=new.

text

Conteúdo da página.

summary

Resumo da edição.

Quando este parâmetro não for fornecido ou estiver vazio, pode ser gerado automaticamente um resumo de edição.

Quando for usado section=new e sectiontitle não for fornecido, o valor deste parâmetro será antes usado para o título da secção e será gerado automaticamente um resumo de edição.

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)
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 (ignorado para robôs) ou não alterar o estado de vigilância.

Um dos seguintes valores: nochange, preferences, unwatch, watch
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 ou secção. Tem precedência sobre text.

appendtext

Adicionar este texto ao fim da página ou secção. 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, application/octet-stream, application/unknown, application/x-binary, text/css, text/javascript, text/plain, text/unknown, text/x-wiki, unknown/unknown
contentmodel

Modelo de conteúdo do novo conteúdo.

Um dos seguintes valores: GadgetDefinition, Scribunto, css, javascript, json, sanitized-css, text, unknown, 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.
returnto

Título da página. Se a gravação da edição tiver criado uma conta temporária, a API pode responder com um URL que o cliente deve visitar para concluir o início da sessão. Se este parâmetro for fornecido, o URL irá redirecionar para a página nele especificada, em vez da página que foi editada.

Tipo: título de página
Aceita páginas que não existem.
returntoquery

Parâmetros de consulta do URL (com um ? inicial). Se a gravação da edição tiver criado uma conta temporária, a API pode responder com um URL que o cliente deve visitar para concluir o início da sessão. Se este parâmetro for fornecido, o URL irá redirecionar para uma página com os parâmetros de consulta fornecidos.

Padrão: (vazio)
returntoanchor

Fragmento de URL (com um # inicial). Se a gravação da edição tiver criado uma conta temporária, a API pode responder com um URL que o cliente deve visitar para concluir o início da sessão. Se este parâmetro for fornecido, o URL irá redirecionar para uma página com o fragmento fornecido.

Padrão: (vazio)
captchaword

Resposta ao CAPTCHA

captchaid

Identificador CAPTCHA do pedido anterior