Ayuda de la API de MediaWiki

Esta es una página de documentación autogenerada de la API de MediaWiki.

Documentación y ejemplos: https://www.mediawiki.org/wiki/Special:MyLanguage/API:Main_page

action=upload

(main | upload)

Este módulo requiere permisos de lectura.
Este módulo requiere permisos de escritura.
Este módulo solo acepta solicitudes POST.
Fuente: MediaWiki
Licencia: GPL-2.0-or-later

Upload a file, or get the status of pending uploads.

Several methods are available:

Upload file contents directly, using the file parameter.
Upload the file in pieces, using the filesize, chunk, and offset parameters.
Have the MediaWiki server fetch a file from a URL, using the url parameter.
Complete an earlier upload, that failed due to warnings, were uploaded in pieces or stored otherwise in the upload stash, using the filekey parameter.

Note that the HTTP POST must be done as a file upload (i.e. using multipart/form-data) when sending the file or chunk.

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

Parámetros específicos:

Other general parameters are available.

filename: Nombre del archivo de destino.
comment: Upload comment. Also used as the initial page text for new files if text is not specified.; Predeterminado: (vacío)
tags: Las etiquetas de cambio que se aplicarán a la entrada del registro de subidas y a la revisión de página de archivo.; Valores (separados por | u otro separador):
text: Texto de página inicial para archivos nuevos.
watch: En desuso.; Vigilar la página.; Tipo: boolean (más información)
watchlist: Añadir o borrar incondicionalmente la página de la lista de seguimiento del usuario actual, utilizar las preferencias o no cambiar el estado de seguimiento.; Uno de los siguientes valores: nochange, preferences, watch; Predeterminado: preferences
ignorewarnings: Ignorar las advertencias.; Tipo: boolean (más información)
file: Contenido del archivo.; Must be posted as a file upload using multipart/form-data.
url: URL de la que obtener el archivo.
filekey: Clave que identifica una carga anterior que se guardó en el almacén provisional.
sessionkey: En desuso.; Idéntico a filekey, mantenido por razones de retrocompatibilidad.
stash: If set, the server will stash the file temporarily instead of adding it to the repository.; Tipo: boolean (más información)
filesize: Tamaño de archivo total de la carga.; Tipo: entero; El valor debe estar entre 0 y 104 857 600.
offset: Posición del fragmento en bytes.; Tipo: entero; El valor debe ser no menor de 0.
chunk: Contenido del fragmento.; Must be posted as a file upload using multipart/form-data.
async: Realizar de forma asíncrona las operaciones de archivo potencialmente grandes cuando sea posible.; Tipo: boolean (más información)
checkstatus: Only fetch the upload status for the given file key.; Tipo: boolean (más información)
token: A "csrf" token retrieved from action=query&meta=tokens; Este parámetro es obligatorio.

Ejemplos:

Subir desde una URL.: api.php?action=upload&filename=Wiki.png&url=http%3A//upload.wikimedia.org/wikipedia/en/b/bc/Wiki.png&token=123ABC [abrir en la zona de pruebas]
Completar una subida que falló debido a advertencias.: api.php?action=upload&filename=Wiki.png&filekey=filekey&ignorewarnings=1&token=123ABC [abrir en la zona de pruebas]