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]