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/API

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:

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: booliano (detalhes)
watchlist: Engadir ou eliminar sen condicións a páxina da lista de vixiancia do usuario actual, use as preferencias ou non cambie a vixiancia.; Un valor dos seguintes valores: nochange, preferences, watch; Valor por omissão: preferences
ignorewarnings: Ignorar as advertencias.; Tipo: booliano (detalhes)
file: Contido do ficheiro.; Deve ser enviado na forma de carregamento de um ficheiro usando 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: booliano (detalhes)
filesize: Tamaño de ficheiro completo da carga.; Tipo: inteiro; O valor tem de estar entre 0 e 104.857.600.
offset: Desaxuste do bloque en bytes.; Tipo: inteiro; O valor não pode ser inferior a 0.
chunk: Contido do bloque.; Deve ser enviado na forma de carregamento de um ficheiro usando multipart/form-data.
async: Facer de forma asíncrona as operacións de ficheiro potencialmente grandes cando sexa posible.; Tipo: booliano (detalhes)
checkstatus: Só buscar o estado da subida da clave de ficheiro indicada.; Tipo: booliano (detalhes)
token: Un identificador "csrf" recuperado por action=query&meta=tokens; Este parâmetro é obrigatório.

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 en zona de probas]
Completar carga que fallou debido a avisos: api.php?action=upload&filename=Wiki.png&filekey=filekey&ignorewarnings=1&token=123ABC [abrir en zona de probas]