Ajuda da API do MediaWiki

Esta é uma página de documentação da API do 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 escrita.
Este módulo só aceita pedidos POST.
Fonte: MediaWiki
Licença: GPL-2.0+

Atualizar um ficheiro, ou obter o estado de carregamentos pendentes.

Estão disponíveis vários métodos:

Carregar diretamente o conteúdo do ficheiro, usando o parâmetro file.
Carregar o ficheiro por segmentos, usando os parâmetros filesize, chunk e offset.
Instruir o servidor do MediaWiki para obter o ficheiro a partir de um URL, usando o parâmetro url.
Terminar um carregamento anterior que falhou devido a avisos, usando o parâmetro filekey.

Note que o POST do HTTP tem de ser feito como um carregamento de ficheiro (isto é, usando multipart/form-data) ao enviar o file.

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

Parâmetros:

filename: O nome de destino do ficheiro.
comment: O comentário do carregamento. Também é usado como texto da página inicial para ficheiros novos se text não for especificado.; Padrão: (vazio)
tags: Etiquetas de modificação a aplicar à entrada do carregamento no registo e à revisão da página de ficheiro.; Valores (separados com | ou alternativas):
text: Texto inicial da página para ficheiros novos.
watch: Obsoleto; Vigiar esta página; Tipo: booleano (detalhes)
watchlist: Adicionar ou remover incondicionalmente a página da lista de páginas vigiadas do utilizador atual, usar as preferências ou não alterar o estado de vigilância.; Um dos seguintes valores: watch, preferences, nochange; Valor por omissão: preferences
ignorewarnings: Ignorar todos os avisos.; Tipo: booleano (detalhes)
file: O conteúdo do ficheiro.; Tem ser enviado (posted) como um carregamento de ficheiro usando multipart/form-data.
url: O URL de onde obter o ficheiro.
filekey: Chave que identifica um carregamento prévio que está temporariamente na área de ficheiros escondidos.
sessionkey: Obsoleto; O mesmo que filekey, mantido para compatibilidade com versões anteriores.
stash: Se definido, o servidor irá colocar temporariamente o ficheiro na área de ficheiros escondidos em vez de o adicionar ao repositório.; Tipo: booleano (detalhes)
filesize: O tamanho do carregamento completo.; O valor tem de estar compreendido entre 0 e 104 857 600.; Tipo: inteiro
offset: Posição do segmento em bytes.; O valor não pode ser inferior a 0.; Tipo: inteiro
chunk: O conteúdo do segmento.; Tem ser enviado (posted) como um carregamento de ficheiro usando multipart/form-data.
async: Tornar assíncronas as operações sobre ficheiros possivelmente grandes, quando possível.; Tipo: booleano (detalhes)
checkstatus: Obter só o estado de carregamento para a chave de ficheiro indicada.; Tipo: booleano (detalhes)
token: Uma chave "csrf" obtida de action=query&meta=tokens; Este parâmetro é obrigatório.

Exemplos:

Carregar 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]
Prosseguir um carregamento que falhou devido a avisos.: api.php?action=upload&filename=Wiki.png&filekey=filekey&ignorewarnings=1&token=123ABC [abrir na página de testes]