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

prop=imageinfo (ii)

(main | query | imageinfo)

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.

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

Parâmetros específicos:

Estão disponíveis outros parâmetros gerais.

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 do ficheiro. Se o utilizador é de uma revisão suprimida, será devolvida uma propriedade userhidden.
userid: Adiciona o identificador do utilizador que carregou cada versão do ficheiro. Se o utilizador é de uma revisão suprimida, será devolvida uma propriedade userhidden.
comment: O comentário da versão. Se o comentário é de uma revisão suprimida, será devolvida uma propriedade commenthidden.
parsedcomment: Fazer a análise sintática do comentário da versão. Se o comentário é de uma revisão suprimida, será devolvida uma propriedade commenthidden.
canonicaltitle: Adiciona o título canónico do ficheiro. Se o ficheiro é de uma revisão suprimida, será devolvida uma propriedade filehidden.
url: Devolve URL para o ficheiro e a página de descrição. Se o ficheiro é de uma revisão suprimida, será devolvida uma propriedade filehidden.
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. Se o ficheiro é de uma revisão suprimida, será devolvida uma propriedade filehidden.
mime: Adiciona o tipo MIME do ficheiro. Se o ficheiro é de uma revisão suprimida, será devolvida uma propriedade filehidden.
thumbmime: Adiciona o tipo MIME da miniatura (requer URL e o parâmetro iiurlwidth). Se o ficheiro é de uma revisão suprimida, será devolvida uma propriedade filehidden.
mediatype: Adiciona o tipo de multimédia do ficheiro. Se o ficheiro é de uma revisão suprimida, será devolvida uma propriedade filehidden.
metadata: Lista os metadados Exif para a versão do ficheiro. Se o ficheiro é de uma revisão suprimida, será devolvida uma propriedade filehidden.
commonmetadata: Lista os metadados genéricos do formato de ficheiro para a versão do ficheiro. Se o ficheiro é de uma revisão suprimida, será devolvida uma propriedade filehidden.
extmetadata: Lista os metadados formatados, combinados de várias fontes. Os resultados estão no formato HTML. Se o ficheiro é de uma revisão suprimida, será devolvida uma propriedade filehidden.
archivename: Adiciona o nome de ficheiro da versão arquivada das versões anteriores à última. Se o ficheiro é de uma revisão suprimida, será devolvida uma propriedade filehidden.
bitdepth: Adiciona a profundidade em bits da versão. Se o ficheiro é de uma revisão suprimida, será devolvida uma propriedade filehidden.
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): archivename, badfile, bitdepth, canonicaltitle, comment, commonmetadata, dimensions, extmetadata, mediatype, metadata, mime, parsedcomment, sha1, size, thumbmime, timestamp, uploadwarning, url, user, userid

Valor por omissão: timestamp|user

iilimit

O número de revisões a serem devolvidas por ficheiro.

Tipo: inteiro ou max

O valor tem de estar entre 1 e 500.

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: booliano (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 clientes a quem são permitidos limites mais elevados).

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. Podem ser encontradas na wiki mediawiki.org mais informações sobre a aplicação da continuação a consultas.

iilocalonly

Procurar ficheiros só no repositório local.

Tipo: booliano (detalhes)

Exemplos:

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 desde 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]