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
- 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
- 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. 
- 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 
- Editar uma página.
- api.php?action=edit&title=Test&summary=test%20summary&text=article%20content&baserevid=1234567&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]