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
prop=imageinfo (ii)
- Este módulo requer direitos de leitura.
- Fonte: MediaWiki
- Licença: GPL-2.0-or-later
Devolve informação do ficheiro e o historial de carregamentos.
- iiprop
As informações do ficheiro que devem ser obtidas:
- timestamp
- Adiciona a data e hora da versão carregada.
- user
- Adiciona o utilizador que carregou cada versão de ficheiro.
- userid
- Adiciona o identificador do utilizador que carregou cada versão de ficheiro.
- comment
- O comentário da versão.
- parsedcomment
- Fazer a análise sintática do comentário da versão.
- canonicaltitle
- Adiciona o título canónico do ficheiro.
- url
- Devolve URL para o ficheiro e página de descrição.
- size
- Adiciona o tamanho do ficheiro em bytes e a altura, largura e contagem de páginas (se aplicável).
- dimensions
- Nome alternativo para size.
- sha1
- Adiciona o resumo criptográfico SHA-1 do ficheiro.
- mime
- Adiciona o tipo MIME do ficheiro.
- thumbmime
- Adiciona o tipo MIME da miniatura (requer URL e o parâmetro iiurlwidth).
- mediatype
- Adiciona o tipo de multimédia do ficheiro.
- metadata
- Lista os metadados Exif para a versão do ficheiro.
- commonmetadata
- Lista os metadados genéricos do formato de ficheiro para a versão do ficheiro.
- extmetadata
- Lista os metadados formatados, combinados de várias fontes. Os resultados estão no formato HTML.
- archivename
- Adiciona o nome de ficheiro da versão arquivada das versões anteriores à última.
- bitdepth
- Adiciona a profundidade em bits da versão.
- uploadwarning
- Usado pela página Special:Upload para obter informação sobre um ficheiro existente. Não se destina a ser usado fora do núcleo central do MediaWiki.
- badfile
- Indica se o ficheiro está na lista MediaWiki:Bad image list
- Valores (separados com | ou alternativas): timestamp, user, userid, comment, parsedcomment, canonicaltitle, url, size, dimensions, sha1, mime, thumbmime, mediatype, metadata, commonmetadata, extmetadata, archivename, bitdepth, uploadwarning, badfile
- Valor por omissão: timestamp|user
- iilimit
O número de revisões a serem devolvidas por ficheiro.
- Não são permitidos mais do que 500 (5 000 para robôs).
- Tipo: inteiro ou max
- Valor por omissão: 1
- iistart
Data e hora a partir da qual será começada a listagem.
- Tipo: data e hora (formatos permitidos)
- iiend
Data e hora na qual será terminada a listagem.
- Tipo: data e hora (formatos permitidos)
- iiurlwidth
Se iiprop=url está definido, será devolvido um URL para uma imagem redimensionada com este comprimento. Por razões de desempenho, se esta opção for usada não serão devolvidas mais de 50 imagens redimensionadas.
- Tipo: inteiro
- Valor por omissão: -1
- iiurlheight
Semelhante a iiurlwidth.
- Tipo: inteiro
- Valor por omissão: -1
- iimetadataversion
Versão de metadados a ser usada. Se for especificado o valor latest, usar a versão mais recente. Por omissão tem o valor 1 para compatibilidade com versões anteriores.
- Valor por omissão: 1
- iiextmetadatalanguage
Em que língua obter extmetadata. Isto afeta tanto a tradução que será obtida, caso existam várias, como a formatação de números e vários outros valores.
- Valor por omissão: pt
- iiextmetadatamultilang
Se estiverem disponíveis traduções para a propriedade extmetadata, obtê-las todas.
- Tipo: booleano (detalhes)
- iiextmetadatafilter
Se for especificado e não estiver vazio, só serão devolvidas estas chaves para iiprop=extmetadata.
- Separar os valores com | ou alternativas. O número máximo de valores é 50 (500 para robôs).
- iiurlparam
Um parâmetro de texto específico do objeto. Por exemplo, ficheiros PDF podem usar page15-100px. iiurlwidth tem de ser usado e ser consistente com iiurlparam.
- Padrão: (vazio)
- iibadfilecontexttitle
Se badfilecontexttitleprop=badfile estiver definido, este é o título da página usado ao calcular a MediaWiki:Bad image list
- iicontinue
Quando houver mais resultados disponíveis, usar isto para continuar
- iilocalonly
Procurar ficheiros só no repositório local.
- Tipo: booleano (detalhes)
- Obter informação sobre a versão atual do ficheiro File:Albert Einstein Head.jpg.
- api.php?action=query&titles=File:Albert%20Einstein%20Head.jpg&prop=imageinfo [abrir na página de testes]
- Obter informação sobre as versões de File:Test.jpg a partir de 2008.
- api.php?action=query&titles=File:Test.jpg&prop=imageinfo&iilimit=50&iiend=2007-12-31T23:59:59Z&iiprop=timestamp|user|url [abrir na página de testes]
![[abrir na página de testes]](/index.php/Especial:ApiSandbox#action=query&titles=File:Albert%20Einstein%20Head.jpg&prop=imageinfo){kind=link}
![[abrir na página de testes]](/index.php/Especial:ApiSandbox#action=query&titles=File:Test.jpg&prop=imageinfo&iilimit=50&iiend=2007-12-31T23:59:59Z&iiprop=timestamp%7Cuser%7Curl){kind=link}