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/Special:MyLanguage/API:Main_page

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-or-later

Carregar um ficheiro, ou obter o estado dos 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.

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 a página.

Tipo: booliano (detalhes)
watchlist

Adicionar ou remover incondicionalmente a página da lista de páginas vigiadas do utilizador atual, usar as preferências (ignorado para robôs) ou não alterar o estado de vigilância.

Um dos seguintes valores: nochange, preferences, watch
Valor por omissão: preferences
ignorewarnings

Ignorar todos os avisos.

Tipo: booliano (detalhes)
file

O conteúdo do ficheiro.

Deve ser enviado na forma de carregamento de um 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: booliano (detalhes)
filesize

O tamanho do carregamento completo.

Tipo: inteiro
O valor tem de estar entre 0 e 104 857 600.
offset

Posição do segmento em bytes.

Tipo: inteiro
O valor não pode ser inferior a 0.
chunk

O conteúdo do segmento.

Deve ser enviado na forma de carregamento de um ficheiro usando multipart/form-data.
async

Tornar assíncronas as operações sobre ficheiros possivelmente grandes, quando possível.

Tipo: booliano (detalhes)
checkstatus

Obter só o estado de carregamento para a chave de ficheiro indicada.

Tipo: booliano (detalhes)
token

Uma chave "csrf" obtida de action=query&meta=tokens

Este parâmetro é obrigatório.