Axuda da API de MediaWiki
Esta é unha páxina de documentación da API de MediaWiki xerada automaticamente.
Documentación e exemplos: https://www.mediawiki.org/wiki/Special:MyLanguage/API:Main_page
action=edit
- Este módulo precisa permisos de lectura.
- Este módulo precisa permisos de escritura.
- Este módulo só acepta peticións POST.
- Fonte: MediaWiki
- Licenza: GPL-2.0-or-later
Crear e editar páxinas.
- title
Título da páxina que quere editar. Non pode usarse xunto con pageid.
- pageid
Identificador da páxina que quere editar. Non pode usarse xunto con title.
- Tipo: número enteiro
- section
Identificador de sección. O 0 é para a sección superior, new para unha sección nova. A miúdo un enteiro positivo, pero tamén pode non ser numérico.
- sectiontitle
O título para unha nova sección ao usares section=new.
- text
Contido da páxina.
- summary
Resumo de edición.
Cando non se proporciona este parámetro ou está baleiro, pode xerarse un resumo de edición automaticamente.
Ao usares section=new e non proporcionares sectiontitle, o valor deste parámetro úsase para o título da sección e xérase automaticamente un resumo de edición.
- tags
Cambiar as etiquetas a aplicar á revisión.
- Valores (separados con | ou outros):
- minor
Marcar isto como unha edición pequena
- Tipo: booleano (detalles)
- notminor
Non marcar esta edición como unha edición pequena aínda que se estableza a preferencia de usuario "Marcar por defecto todas as edicións como edicións pequenas".
- Tipo: booleano (detalles)
- bot
Marcar esta edición como de bot.
- Tipo: booleano (detalles)
- baserevid
Identificador da revisión base, usado para detectar conflitos de edición. Pode obterse mediante action=query&prop=revisions. Os conflitos propios fan que a edición falle agás que se estableza o parámetro basetimestamp.
- Tipo: número enteiro
- basetimestamp
Selo de tempo da revisión de base, usado para detectar conflitos de edición. Pode obterse mediante action=query&prop=revisions&rvprop=timestamp. Ignóranse os conflitos propios.
- Tipo: selo de tempo (formatos permitidos)
- starttimestamp
Selo de tempo do comezo do proceso de edición, usado para detectar conflitos de edición. Pode obterse un valor axeitado usando curtimestamp cando se comeza o proceso de edición (por exemplo, cando se carga o contido da páxina a editar).
- Tipo: selo de tempo (formatos permitidos)
- recreate
Ignorar todos os erros da páxina mentres está a ser borrada.
- Tipo: booleano (detalles)
- createonly
Non editar a páxina se xa existe.
- Tipo: booleano (detalles)
- nocreate
Amosar un mensaxe de erro se a páxina non existe
- Tipo: booleano (detalles)
- watch
- Obsoleto.
Engadir esta páxina á lista de vixilancia do usuario actual.
- Tipo: booleano (detalles)
- unwatch
- Obsoleto.
Eliminar esta páxina da lista de vixilancia do usuario actual.
- Tipo: booleano (detalles)
- watchlist
Engadir ou eliminar incondicionalmente a páxina da lista de vixilancia do usuario actual, usar as preferencias (ignórase para os usuarios que son bots) ou non cambiar a vixilancia.
- Un valor dos seguintes valores: nochange, preferences, unwatch, watch
- Por defecto: preferences
- md5
A función hash MD5 do parámetro text, ou dos parámetros prependtext e appendtext concatenados. Se está definida, non se fará a edición ata que a función hash sexa correcta.
- prependtext
Engadir este texto ao comezo da páxina ou sección. Sobrescribe text.
- appendtext
Engadir este texto ao comezo da páxina ou sección. Sobrescribe text.
Usa section=new para engadir unha nova sección, no canto deste parámetro.
- undo
Desfacer esta revisión. Ignorar text, prependtext e appendtext.
- Tipo: número enteiro
- O valor non debe ser inferior a 0.
- undoafter
Desfacer tódalas revisións dende undo ata esta. Se non está definido, só desfacer unha revisión.
- Tipo: número enteiro
- O valor non debe ser inferior a 0.
- redirect
Resolver redireccións automaticamente
- Tipo: booleano (detalles)
- contentformat
Formato de serialización de contido utilizado para o texto de entrada.
- Un valor 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 contido para o novo contido.
- Un valor dos seguintes valores: css, javascript, json, text, unknown, wikitext
- token
Un identificador "csrf" recuperado por action=query&meta=tokens
O identificador debería enviarse empre como o último parámetro, ou polo menos despois do parámetro text.
- Este parámetro é obrigatorio.
- Editar a páxina
- api.php?action=edit&title=Test&summary=test%20summary&text=article%20content&baserevid=1234567&token=123ABC [abrir na zona de probas]
- Antepor __NOTOC__ a unha páxina.
- api.php?action=edit&title=Test&summary=NOTOC&minor=&prependtext=__NOTOC__%0A&basetimestamp=2007-08-24T12:34:54Z&token=123ABC [abrir na zona de probas]
- Desfacer revisións 13579 a 13585 con resumo automático.
- api.php?action=edit&title=Test&undo=13585&undoafter=13579&basetimestamp=2007-08-24T12:34:54Z&token=123ABC [abrir na zona de probas]