Ajuda da API MediaWiki
Esta é uma página de documentação da API 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 gravação.
- Este módulo aceita apenas pedidos POST.
- Fonte: MediaWiki
- Licença: GPL-2.0-or-later
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 em conjunto com title.
- Tipo: inteiro
- section
Número da seção. 0 para a seção superior, new para uma nova seção.
- sectiontitle
O título para uma nova seção.
- text
Conteúdo da página.
- summary
Edit o resumo. Também o título da seção quando section=new e sectiontitle não está definido.
Alterar as tags para aplicar à revisão.
- Valores (separados com | ou alternativos):
- minor
Marque esta edição como uma edição menor.
- Tipo: booleano (detalhes)
- notminor
Não marque esta edição como uma edição menor, mesmo se a preferência do usuário "Marcar todas as edições como menores por padrão" é definida.
- Tipo: booleano (detalhes)
- bot
Marcar esta edição como uma edição de bot.
- Tipo: booleano (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
O timestamp da revisão base, usada para detectar conflitos de edição, pode ser obtido através de action=query&prop=revisions&rvprop=timestamp.
- Tipo: data e hora (formatos permitidos)
- starttimestamp
Timestamp quando o processo de edição começou, usado para detectar conflitos de edição. Um valor apropriado pode ser obtido usando curtimestamp ao iniciar o processo de edição (por exemplo, ao carregar o conteúdo da página a editar).
- Tipo: data e hora (formatos permitidos)
- recreate
Substitua quaisquer erros sobre a página que foram eliminados enquanto isso.
- Tipo: booleano (detalhes)
- createonly
Não editar a página se ela 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 páginas vigiadas do usuário atual.
- Tipo: booleano (detalhes)
- unwatch
- Obsoleto.
Remove a página da lista de páginas vigiadas do usuário atual.
- Tipo: booleano (detalhes)
- watchlist
Adicione ou remova incondicionalmente a página da lista de páginas vigiadas do usuário atual, use preferências (ignoradas para usuários de robô) ou não mude a vigilância.
- Um dos seguintes valores: nochange, preferences, unwatch, watch
- Padrão: preferences
- md5
O hash MD5 do parâmetro text ou os parâmetros prependtext e appendtext concatenados. Se configurado, a edição não será feita a menos que o hash esteja correto.
- prependtext
Adiciona este texto ao início da página. Substitui text.
- appendtext
Adiciona este texto ao fim da página. Substitui text.
Use section=new para anexar uma nova seção, em vez deste parâmetro.
- undo
Desfazer esta revisão. Substitui text, prependtext e appendtext.
- Tipo: inteiro
- O valor não pode ser inferior a 0.
- undoafter
Desfazer todas as revisões de undo para este. Se não estiver configurado, desfaz uma revisão.
- Tipo: inteiro
- O valor não pode ser inferior a 0.
- redirect
Resolve redirecionamento automaticamente.
- Tipo: booleano (detalhes)
- contentformat
Formato de serialização de 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: css, javascript, json, text, unknown, wikitext
- 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)
- token
Um token "csrf" token recuperado de action=query&meta=tokens
O token sempre deve ser enviado como o ú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&baserevid=1234567&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 as revisões 13579 até 13585 com sumário 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]