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=upload

(main | upload)

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

Subir un ficheiro, ou obter o estado das subas pendentes.

Hai varios métodos dispoñibles:

Subir o contido do ficheiro directamente, usando o parámetro file.
Subir o ficheiro por partes, usando os parámetros filesize, chunk, e offset.
Mandar ó servidor MediaWiki que colla un ficheiro dunha URL, usando o parámetro url.
Completar unha suba anterior que fallou a causa dos avisos, usando o parámetro filekey.

Teña en conta que o HTTP POST debe facerse como suba de ficheiro (p.ex. usando multipart/form-data)cando se envie o file.

https://www.mediawiki.org/wiki/Special:MyLanguage/API:Upload

Parámetros específicos:

Hai dispoñibles outros parámetros xerais.

filename: Nome de ficheiro obxectivo.
comment: Subir comentario. Tamén usado como texto da páxina inicial para ficheiros novos se non se especifica text.; Por defecto: (baleiro)
tags: Cambiar etiquetas a aplicar á entrada do rexistro de subas e á revisión de páxina de ficheiro.; Valores (separados con | ou outros):
text: Texto da páxina inicial para novos ficheiros.
watch: Obsoleto.; Vixiar a páxina.; 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, watch; Por defecto: preferences
watchlistexpiry: Selo temporal para a caducidade da lista de vixilancia. Omitir este parámetro por completo para deixar a caducidade actual sen cambios.; Tipo: caducidade (detalles)
ignorewarnings: Ignorar as advertencias.; Tipo: booleano (detalles)
file: Contido do ficheiro.; Debe enviarse como unha carga de ficheiros utilizando multipart/form-data.
url: URL onde buscar o ficheiro.
filekey: Clave que identifica unha subida precedente e que foi almacenada temporalmente.
sessionkey: Obsoleto.; Igual a filekey, mantido por razóns de compatibilidade con procesos antigos.
stash: Se está indicado, o servidor almacenará o ficheiro temporalmente no canto de engadilo ó repositorio.; Tipo: booleano (detalles)
filesize: Tamaño de ficheiro completo da carga.; Tipo: número enteiro; O valor debe estar entre 0 e 5.368.709.120.
offset: Desaxuste do bloque en bytes.; Tipo: número enteiro; O valor non debe ser inferior a 0.
chunk: Contido do bloque.; Debe enviarse como unha carga de ficheiros utilizando multipart/form-data.
async: Facer de forma asíncrona as operacións de ficheiro potencialmente grandes cando sexa posible.; Tipo: booleano (detalles)
checkstatus: Só buscar o estado da subida da clave de ficheiro indicada.; Tipo: booleano (detalles)
token: Un identificador "csrf" recuperado por action=query&meta=tokens; Este parámetro é obrigatorio.

Exemplos:

Carga dunha URL: api.php?action=upload&filename=Wiki.png&url=http%3A//upload.wikimedia.org/wikipedia/en/b/bc/Wiki.png&token=123ABC [abrir na zona de probas]
Completar carga que fallou debido a avisos: api.php?action=upload&filename=Wiki.png&filekey=filekey&ignorewarnings=1&token=123ABC [abrir na zona de probas]