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

list=allimages (ai)

(main | query | allimages)
  • Este módulo requer direitos de leitura.
  • Este módulo pode ser usado como gerador.
  • Fonte: MediaWiki
  • Licença: GPL-2.0-or-later

Enumerar todas as imagens sequencialmente.

Parâmetros específicos:
Estão disponíveis outros parâmetros gerais.
aisort

Propriedade pela qual fazer a ordenação.

Um dos seguintes valores: name, timestamp
Valor por omissão: name
aidir

A direção de listagem.

Um dos seguintes valores: ascending, descending, newer, older
Valor por omissão: ascending
aifrom

O título da imagem a partir do qual será começada a enumeração. Só pode ser usado com aisort=name.

aito

O título da imagem no qual será terminada a enumeração. Só pode ser usado com aisort=name.

aicontinue

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.

aistart

A data e hora da imagem a partir da qual será começada a enumeração. Só pode ser usado com aisort=timestamp.

Tipo: data e hora (formatos permitidos)
aiend

A data e hora da imagem na qual será terminada a enumeração. Só pode ser usado com aisort=timestamp.

Tipo: data e hora (formatos permitidos)
aiprop

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.
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.
bitdepth
Adiciona a profundidade em bits da versão. Se o ficheiro é de uma revisão suprimida, será devolvida uma propriedade filehidden.
badfile
Indica se o ficheiro está na lista MediaWiki:Bad image list
Valores (separados com | ou alternativas): badfile, bitdepth, canonicaltitle, comment, commonmetadata, dimensions, extmetadata, mediatype, metadata, mime, parsedcomment, sha1, size, timestamp, url, user, userid
Valor por omissão: timestamp|url
aiprefix

Procurar todos os títulos de imagem que começam por este valor. Só pode ser usado com aisort=name.

aiminsize

Limitar só às imagens com este número mínimo de bytes.

Tipo: inteiro
aimaxsize

Limitar só às imagens com este número máximo de bytes.

Tipo: inteiro
aisha1

Resumo criptográfico SHA1 da imagem. Tem precedência sobre aisha1base36.

aisha1base36

Resumo criptográfico SHA1 da imagem em base 36 (usado no MediaWiki).

aiuser

Só devolver ficheiros cuja última versão tenha sido carregada por este utilizador. Só pode ser usado com aisort=timestamp. Não pode ser usado em conjunto com aifilterbots.

Tipo: utilizador, por um de entre nome de utilizador, IP, nome interwikis (p. ex. "prefixo>NomeDeExemplo") e identificador de utilizador (p. ex. "#12345")
aifilterbots

Como filtrar os ficheiros carregados por robôs. Só pode ser usado com aisort=timestamp. Não pode ser usado em conjunto com aiuser.

Um dos seguintes valores: all, bots, nobots
Valor por omissão: all
aimime

Tipos MIME a procurar; por exemplo, image/jpeg.

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).
ailimit

O número total de imagens a serem devolvidas.

Tipo: inteiro ou max
O valor tem de estar entre 1 e 500.
Valor por omissão: 10
Exemplos:
Mostrar uma lista dos ficheiros que começam com a letra B.
api.php?action=query&list=allimages&aifrom=B [abrir na página de testes]
Mostrar uma lista dos ficheiros carregados recentemente, semelhante a Special:NewFiles.
api.php?action=query&list=allimages&aiprop=user|timestamp|url&aisort=timestamp&aidir=older [abrir na página de testes]
Mostrar uma lista dos ficheiros com os tipos MIME image/png ou image/gif.
api.php?action=query&list=allimages&aimime=image/png|image/gif [abrir na página de testes]
Mostrar informação sobre 4 ficheiros, começando pela letra T.
api.php?action=query&generator=allimages&gailimit=4&gaifrom=T&prop=imageinfo [abrir na página de testes]