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, 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.

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.; Type: boolean (details)
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.; Type: boolean (details)
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.; Type: boolean (details)
filesize: Tamaño de archivo total de la carga.; Tipo: entero; The value must be between 0 and 104 857 600.
offset: Posición del fragmento en bytes.; Tipo: entero; The value must be no less than 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.; Type: boolean (details)
checkstatus: Only fetch the upload status for the given file key.; Type: boolean (details)
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]