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
- 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.
- 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)
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 1 310 720 000.
- 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.
- 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]
![[abrir na página de testes]](/Especial:ApiSandbox#action=upload&filename=Wiki.png&url=http%3A//upload.wikimedia.org/wikipedia/en/b/bc/Wiki.png&token=123ABC){kind=link}
![[abrir na página de testes]](/Especial:ApiSandbox#action=upload&filename=Wiki.png&filekey=filekey&ignorewarnings=1&token=123ABC){kind=link}