Ajuda da API MediaWiki

Esta é uma página de documentação da API MediaWiki gerada automaticamente.

Documentação e exemplos: https://www.mediawiki.org/wiki/API

action=upload

(main | upload)

Este módulo requer direitos de leitura.
Este módulo requer direitos de gravação.
Este módulo aceita apenas pedidos POST.
Fonte: MediaWiki
Licença: GPL-2.0-or-later

Carregue um arquivo ou obtenha o status dos carregamentos pendentes.

Vários métodos estão disponíveis:

Carrega o conteúdo do arquivo diretamente, usando o parâmetro file.
Carrega o arquivo em pedaços, usando os parâmetros filesize, chunk e offset.
Tenha o servidor MediaWiki buscando um arquivo de um URL, usando o parâmetro url.
Complete um carregamento anterior que falhou devido a avisos, usando o parâmetro filekey.

Note que o HTTP POST deve ser feito como um upload de arquivo (ou seja, usando multipart/form-data) ao enviar o file.

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

Parâmetros:

filename: Nome do arquivo de destino.
comment: Faça o upload do comentário. Também usado como o texto da página inicial para novos arquivos, se text não for especificado.; Padrão: (vazio)
tags: Alterar as tags para aplicar à entrada do log de upload e à revisão da página do arquivo.; Valores (separados com | ou alternativos):
text: Texto inicial da página para novos arquivos.
watch: Obsoleto.; Vigiar esta página.; Tipo: boleano (details)
watchlist: Adicione ou remova incondicionalmente a página da lista de páginas vigiadas do usuário atual, use preferências ou não mude a vigilância.; Um dos seguintes valores: watch, preferences, nochange; Padrão: preferences
ignorewarnings: Ignorar quaisquer avisos.; Tipo: boleano (details)
file: Conteúdo do arquivo.; Deve ser postado como um upload de arquivo usando multipart/form-data.
url: URL do qual para buscar o arquivo.
filekey: Chave que identifica um upload anterior que foi temporariamente armazenado.
sessionkey: Obsoleto.; Igual a filekey, mantido para compatibilidade com versões anteriores.
stash: Se configurado, o servidor armazenará o arquivo temporariamente em vez de adicioná-lo ao repositório.; Tipo: boleano (details)
filesize: Tamanho completo do upload.; O valor deve estar entre 0 e 104 857 600.; Tipo: inteiro
offset: Deslocamento de pedaços em bytes.; O valor não pode ser inferior a 0.; Tipo: inteiro
chunk: Conteúdo do pedaço.; Deve ser postado como um upload de arquivo usando multipart/form-data.
async: Tornar as operações de arquivo potencialmente grandes assíncronas quando possível.; Tipo: boleano (details)
checkstatus: Apenas obtenha o status de upload para a chave de arquivo fornecida.; Tipo: boleano (details)
token: Um token "csrf" token recuperado de action=query&meta=tokens; Este parâmetro é obrigatório.

Exemplos:

Enviar a partir de um URL.: api.php?action=upload&filename=Wiki.png&url=http%3A//upload.wikimedia.org/wikipedia/en/b/bc/Wiki.png&token=123ABC [abrir na página de testes]
Complete um upload que falhou devido a avisos.: api.php?action=upload&filename=Wiki.png&filekey=filekey&ignorewarnings=1&token=123ABC [abrir na página de testes]