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/Special:MyLanguage/API:Main_page
action=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.
- 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)
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: booleano (detalhes)
- watchlist
Adicione ou remova incondicionalmente a página da lista de páginas vigiadas do usuário atual, use preferências (ignoradas para usuários de robô) ou não mude a vigilância.
- Um dos seguintes valores: nochange, preferences, watch
- Padrão: preferences
- ignorewarnings
Ignorar quaisquer avisos.
- Tipo: booleano (detalhes)
- 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: booleano (detalhes)
- filesize
Tamanho completo do upload.
- Tipo: inteiro
- O valor deve estar entre 0 e 104 857 600.
- offset
Deslocamento de pedaços em bytes.
- Tipo: inteiro
- O valor não pode ser inferior a 0.
- 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: booleano (detalhes)
- checkstatus
Apenas obtenha o status de upload para a chave de arquivo fornecida.
- Tipo: booleano (detalhes)
- token
Um token "csrf" token recuperado de action=query&meta=tokens
- Este parâmetro é obrigatório.
- 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]