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=query
- Este módulo requer direitos de leitura.
- Fonte: MediaWiki
- Licença: GPL-2.0-or-later
Obter dados de, e sobre, o MediaWiki.
Todas as modificações de dados terão primeiro que usar uma consulta para adquirir uma chave, o que visa impedir abusos de sítios maliciosos.
- https://www.mediawiki.org/wiki/Special:MyLanguage/API:Query
- https://www.mediawiki.org/wiki/Special:MyLanguage/API:Meta
- https://www.mediawiki.org/wiki/Special:MyLanguage/API:Properties
- https://www.mediawiki.org/wiki/Special:MyLanguage/API:Lists
- prop
As propriedades a serem obtidas para as páginas consultadas.
- categories
- Listar todas as categorias às quais as páginas pertencem.
- categoryinfo
- Devolve informação sobre as categorias indicadas.
- cirrusbuilddoc
- Cópia em ficheiro do documento de um artigo CirrusSearch dos servidores da base de dados
- cirruscompsuggestbuilddoc
- Cópia em ficheiro do documento usado pelas sugestões de preenchimento
- cirrusdoc
- Cópia em ficheiro do documento de um artigo CirrusSearch dos servidores de pesquisa
- contributors
- Obter a lista dos contribuidores autenticados e o número de contribuidores não autenticados de uma página.
- deletedrevisions
- Obter informações sobre as revisões eliminadas.
- duplicatefiles
- Listar todos os ficheiros que são duplicados dos ficheiros indicados com base no seu resumo criptográfico.
- extlinks
- Devolve todos os URL externos (que não sejam interwikis) das páginas especificadas.
- extracts
- Fornece extratos do conteúdo das páginas indicadas, em texto simples ou HTML limitado.
- fileusage
- Encontrar todas as páginas que usam os ficheiros indicados.
- globalusage
- Devolve a utilização global de uma certa imagem.
- imageforpage
- Pré-compõe e fornece os URL para as imagens, para uma determinada página do espaço nominal "Página:".
- imageinfo
- Devolve informação do ficheiro e o historial de carregamentos.
- images
- Devolve todos os ficheiros contidos nas páginas indicadas.
- info
- Obter a informação básica da página.
- iwlinks
- Devolve todas as hiperligações interwikis das páginas indicadas.
- langlinks
- Devolve todas as hiperligações interlínguas das páginas indicadas.
- links
- Devolve todas as hiperligações das páginas indicadas.
- linkshere
- Encontrar todas as páginas que contêm hiperligações para as páginas indicadas.
- mmcontent
- Obter a descrição e os alvos de uma lista de spam
- pageprops
- Obter várias propriedades de página definidas no conteúdo da página.
- pageterms
- Obter os termos Wikidata (tipicamente rótulos, descrições e nomes alternativos) associados a uma página através de uma hiperligação intersites.
- pageviews
- Mostra dados de visionamento de páginas individuais (o número de visionamentos diários em cada um dos últimos pvipdays dias).
- proofread
- Devolve informações sobre o estado de revisão atual das páginas fornecidas.
- redirects
- Devolve todos os redirecionamentos para as páginas indicadas.
- revisions
- Obter informação da revisão.
- stashimageinfo
- Devolve informações dos ficheiros escondidos.
- templates
- Devolve todas as páginas que são transcluídas nas páginas indicadas.
- transcludedin
- Obter todas as páginas que transcluem as páginas indicadas.
- transcodestatus
- Obter o estado da transcodificação de um dado ficheiro.
- videoinfo
- Expande imageinfo para incluir informações sobre a fonte (e obras derivadas) do vídeo
- wbentityusage
- Devolve os identificadores de todas as entidades usadas nas páginas especificadas.
- defaultcontentforpage
- Interno. Provides the default content for a given page in the "Page:" namespace.
The default content is raw wikitext (potentially including raw HTML tags from untrusted book text layers). It must not be used in HTML unescaped/unparsed!
- description
- Interno. Obter uma descrição breve, isto é, um subtítulo que explica o objetivo da página de destino.
- mapdata
- Interno. Pedir todos os dados cartográficos do Kartographer para as páginas especificadas
- Valores (separados com | ou alternativas): categories, categoryinfo, cirrusbuilddoc, cirruscompsuggestbuilddoc, cirrusdoc, contributors, deletedrevisions, duplicatefiles, extlinks, extracts, fileusage, globalusage, imageforpage, imageinfo, images, info, iwlinks, langlinks, links, linkshere, mmcontent, pageprops, pageterms, pageviews, proofread, redirects, revisions, stashimageinfo, templates, transcludedin, transcodestatus, videoinfo, wbentityusage, defaultcontentforpage, description, mapdata
- list
As listas a serem obtidas.
- abusefilters
- Mostrar detalhes dos filtros de abuso.
- abuselog
- Mostrar os eventos que foram detetados por um dos filtros de abuso.
- allcategories
- Enumerar todas as categorias.
- alldeletedrevisions
- Listar todas as revisões eliminadas por um utilizador ou de um espaço nominal.
- allfileusages
- Listar todas as utilizações de ficheiros, incluindo ficheiros que não existam.
- allimages
- Enumerar todas as imagens sequencialmente.
- alllinks
- Enumerar todas as hiperligações que apontam para um determinado espaço nominal.
- allpages
- Enumerar sequencialmente todas as páginas de um determinado espaço nominal.
- allredirects
- Listar todos os redirecionamentos para um espaço nominal.
- allrevisions
- Listar todas as revisões.
- alltransclusions
- Listar todas as transclusões (páginas incorporadas utilizando {{x}}), incluindo as que estejam em falta.
- allusers
- Enumerar todos os utilizadores registados.
- backlinks
- Encontrar todas as páginas que contêm hiperligações para a página indicada.
- betafeatures
- Lista todas as Funcionalidades Beta
- blocks
- Listar todos os utilizadores e endereços IP bloqueados.
- categorymembers
- Listar todas as páginas numa categoria específica.
- centralnoticeactivecampaigns
- Obter uma lista dos avisos que estão ativos, com datas de início e fim, e dos modelos associados.
- centralnoticelogs
- Obter um registo das alterações de configuração de avisos.
- checkuser
- Verificar que endereços IP são usados por determinado nome de utilizador ou que nomes de utilizador são usados por um determinado endereço IP.
- checkuserlog
- Obter entradas do registo de verificação de utilizadores.
- embeddedin
- Encontrar todas as páginas que incorporam (transcluem) o título indicado.
- exturlusage
- Enumerar as páginas que contêm um determinado URL.
- filearchive
- Enumerar todos os ficheiros eliminados sequencialmente.
- gadgetcategories
- Devolve uma lista de categorias de gadgets.
- gadgets
- Devolve uma lista dos gadgets usados nesta wiki.
- globalallusers
- Enumerar todos os utilizadores globais.
- globalblocks
- Listar todos os endereços IP bloqueados globalmente.
- globalgroups
- Enumerar todos os grupos globais.
- imageusage
- Encontrar todas as páginas que utilizam o título da imagem indicada.
- iwbacklinks
- Encontrar todas as páginas que contêm hiperligações para as páginas indicadas.
- langbacklinks
- Encontrar todas as páginas que contêm hiperligações para a hiperligação interlínguas indicada.
- linterrors
- Obter uma lista de erros de lint
- logevents
- Obter eventos dos registos.
- messagecollection
- Consultar MessageCollection sobre traduções.
- mostviewed
- Lista as páginas mais vistas (com base na contagem de visionamentos de ontem).
- mystashedfiles
- Obter uma lista dos ficheiros que estão na área de ficheiros escondidos do utilizador atual.
- pagepropnames
- Listar todos os nomes de propriedades de páginas em uso nesta wiki.
- pageswithprop
- Listar todas as páginas que usam uma determinada propriedade.
- prefixsearch
- Realizar uma procura de prefixo nos títulos de página.
- proofreadpagesinindex
- Listar as páginas de um índice específico
- protectedtitles
- Listar todos os títulos cuja criação está impedida.
- querypage
- Obter uma lista fornecida por uma página especial baseada em consultas (QueryPage).
- random
- Obter um conjunto de páginas aleatórias.
- recentchanges
- Enumerar as mudanças recentes.
- search
- Efetuar uma pesquisa do texto integral.
- tags
- Listar as etiquetas de modificação.
- usercontribs
- Obter todas as edições de um utilizador.
- users
- Obter informações sobre uma lista de utilizadores.
- watchlist
- Obter mudanças recentes das páginas vigiadas do utilizador atual.
- watchlistraw
- Obter todas as páginas na lista de páginas vigiadas do utilizador atual.
- wblistentityusage
- Devolve todas as páginas que usam os identificadores de identidades especificados.
- wikisets
- Enumerar todos os conjuntos de wikis.
- deletedrevs
- Obsoleto. Listar as revisões eliminadas.
- messagegroupsubscription
- Interno. List message groups the current user is subscribed to.
- readinglistentries
- Interno. Listar as páginas de uma certa lista.
- Valores (separados com | ou alternativas): abusefilters, abuselog, allcategories, alldeletedrevisions, allfileusages, allimages, alllinks, allpages, allredirects, allrevisions, alltransclusions, allusers, backlinks, betafeatures, blocks, categorymembers, centralnoticeactivecampaigns, centralnoticelogs, checkuser, checkuserlog, embeddedin, exturlusage, filearchive, gadgetcategories, gadgets, globalallusers, globalblocks, globalgroups, imageusage, iwbacklinks, langbacklinks, linterrors, logevents, messagecollection, mostviewed, mystashedfiles, pagepropnames, pageswithprop, prefixsearch, proofreadpagesinindex, protectedtitles, querypage, random, recentchanges, search, tags, usercontribs, users, watchlist, watchlistraw, wblistentityusage, wikisets, deletedrevs, messagegroupsubscription, readinglistentries
- O número máximo de valores é 50 (500 para clientes a quem são permitidos limites mais elevados).
- meta
Os metadados a serem obtidos.
- allmessages
- Devolver as mensagens deste sítio.
- authmanagerinfo
- Obter informação sobre o atual estado de autenticação.
- babel
- Obter informação sobre as línguas que o utilizador conhece
- featureusage
- Obter um resumo dos usos registados de funcionalidades da API para um agente do utilizador.
- filerepoinfo
- Devolver meta informação sobre os repositórios de imagens configurados na wiki.
- globalpreferences
- Obter as preferências globais do utilizador corrente.
- globalrenamestatus
- Mostrar informação sobre as alterações globais de nome que estão em progresso.
- globaluserinfo
- Mostrar informação sobre um utilizador global.
- languageinfo
- Devolver informações sobre as línguas disponíveis.
- languagestats
- Consultar estatísticas de línguas.
- linterstats
- Obter o número de erros de lint em cada categoria
- managemessagegroups
- Obter possíveis alterações do nome para uma mensagem de um grupo durante as importações
- messagegroups
- Devolver informação sobre grupos de mensagens.
- messagegroupstats
- Consultar estatísticas do grupo de mensagens.
- messagetranslations
- Consultar todas as traduções de uma única mensagem.
- notifications
- Obter notificações à espera do utilizador atual.
- proofreadinfo
- Devolver informações sobre a configuração da extensão ProofreadPage.
- siteinfo
- Devolver informação geral sobre o sítio.
- siteviews
- Mostra dados de visionamento de todas as páginas do sítio (o número de visionamentos diários em cada um dos últimos pvisdays dias).
- tokens
- Obtém chaves para operações de modificação de dados.
- unreadnotificationpages
- Obter as páginas que contêm notificações não lidas para o utilizador atual.
- userinfo
- Obter informações sobre o utilizador atual.
- wikibase
- Obter informação sobre o cliente Wikibase e o repositório Wikibase associado.
- oath
- Interno. Verificar se a autenticação de dois fatores (OATH) está ativa para um utilizador.
- readinglists
- Interno. Listar ou filtrar as listas de leitura do utilizador e mostrar metadados sobre elas.
- Valores (separados com | ou alternativas): allmessages, authmanagerinfo, babel, featureusage, filerepoinfo, globalpreferences, globalrenamestatus, globaluserinfo, languageinfo, languagestats, linterstats, managemessagegroups, messagegroups, messagegroupstats, messagetranslations, notifications, proofreadinfo, siteinfo, siteviews, tokens, unreadnotificationpages, userinfo, wikibase, oath, readinglists
- indexpageids
Incluir uma secção adicional de identificadores de página que lista todos os identificadores de página devolvidos.
- Tipo: booliano (detalhes)
- export
Exportar as revisões atuais de todas as páginas fornecidas ou geradas.
- Tipo: booliano (detalhes)
- exportnowrap
Devolver o XML de exportação sem envolvê-lo num resultado XML (o mesmo formato que Special:Export). Só pode ser usado com query+export.
- Tipo: booliano (detalhes)
- exportschema
Ao exportar, fazê-lo para a versão fornecida do formato da exportação XML. Só pode ser usado com query+export.
- Um dos seguintes valores: 0.10, 0.11
- Valor por omissão: 0.11
- iwurl
Indica se deve ser obtido o URL completo quando o título é uma hiperligação interwikis.
- Tipo: booliano (detalhes)
- continue
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.
- rawcontinue
Devolver os dados em bruto de query-continue para continuar.
- Tipo: booliano (detalhes)
- titles
Uma lista dos títulos a serem trabalhados.
- 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).
- pageids
Uma lista dos identificadores de página a serem trabalhados.
- Tipo: lista de inteiros
- 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).
- revids
Uma lista dos identificadores das revisões a serem trabalhadas. Note que quase todos os módulos de consulta convertem os identificadores de revisões no correspondente identificador de página e trabalham antes sobre a última revisão da página. Só prop=revisions usa revisões exatas para a sua resposta.
- Tipo: lista de inteiros
- 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).
- generator
Obter a lista de páginas nas quais trabalhar, executando o módulo de consulta especificado.
Nota: Os nomes dos parâmetros de geradores têm de ser prefixados com um "g", veja os exemplos.
- allcategories
- Enumerar todas as categorias.
- alldeletedrevisions
- Listar todas as revisões eliminadas por um utilizador ou de um espaço nominal.
- allfileusages
- Listar todas as utilizações de ficheiros, incluindo ficheiros que não existam.
- allimages
- Enumerar todas as imagens sequencialmente.
- alllinks
- Enumerar todas as hiperligações que apontam para um determinado espaço nominal.
- allpages
- Enumerar sequencialmente todas as páginas de um determinado espaço nominal.
- allredirects
- Listar todos os redirecionamentos para um espaço nominal.
- allrevisions
- Listar todas as revisões.
- alltransclusions
- Listar todas as transclusões (páginas incorporadas utilizando {{x}}), incluindo as que estejam em falta.
- backlinks
- Encontrar todas as páginas que contêm hiperligações para a página indicada.
- categories
- Listar todas as categorias às quais as páginas pertencem.
- categorymembers
- Listar todas as páginas numa categoria específica.
- deletedrevisions
- Obter informações sobre as revisões eliminadas.
- duplicatefiles
- Listar todos os ficheiros que são duplicados dos ficheiros indicados com base no seu resumo criptográfico.
- embeddedin
- Encontrar todas as páginas que incorporam (transcluem) o título indicado.
- exturlusage
- Enumerar as páginas que contêm um determinado URL.
- fileusage
- Encontrar todas as páginas que usam os ficheiros indicados.
- images
- Devolve todos os ficheiros contidos nas páginas indicadas.
- imageusage
- Encontrar todas as páginas que utilizam o título da imagem indicada.
- iwbacklinks
- Encontrar todas as páginas que contêm hiperligações para as páginas indicadas.
- langbacklinks
- Encontrar todas as páginas que contêm hiperligações para a hiperligação interlínguas indicada.
- links
- Devolve todas as hiperligações das páginas indicadas.
- linkshere
- Encontrar todas as páginas que contêm hiperligações para as páginas indicadas.
- messagecollection
- Consultar MessageCollection sobre traduções.
- mostviewed
- Lista as páginas mais vistas (com base na contagem de visionamentos de ontem).
- pageswithprop
- Listar todas as páginas que usam uma determinada propriedade.
- prefixsearch
- Realizar uma procura de prefixo nos títulos de página.
- proofreadpagesinindex
- Listar as páginas de um índice específico
- protectedtitles
- Listar todos os títulos cuja criação está impedida.
- querypage
- Obter uma lista fornecida por uma página especial baseada em consultas (QueryPage).
- random
- Obter um conjunto de páginas aleatórias.
- recentchanges
- Enumerar as mudanças recentes.
- redirects
- Devolve todos os redirecionamentos para as páginas indicadas.
- revisions
- Obter informação da revisão.
- search
- Efetuar uma pesquisa do texto integral.
- templates
- Devolve todas as páginas que são transcluídas nas páginas indicadas.
- transcludedin
- Obter todas as páginas que transcluem as páginas indicadas.
- watchlist
- Obter mudanças recentes das páginas vigiadas do utilizador atual.
- watchlistraw
- Obter todas as páginas na lista de páginas vigiadas do utilizador atual.
- wblistentityusage
- Devolve todas as páginas que usam os identificadores de identidades especificados.
- readinglistentries
- Interno. Listar as páginas de uma certa lista.
- Um dos seguintes valores: allcategories, alldeletedrevisions, allfileusages, allimages, alllinks, allpages, allredirects, allrevisions, alltransclusions, backlinks, categories, categorymembers, deletedrevisions, duplicatefiles, embeddedin, exturlusage, fileusage, images, imageusage, iwbacklinks, langbacklinks, links, linkshere, messagecollection, mostviewed, pageswithprop, prefixsearch, proofreadpagesinindex, protectedtitles, querypage, random, recentchanges, redirects, revisions, search, templates, transcludedin, watchlist, watchlistraw, wblistentityusage, readinglistentries
- redirects
Resolver automaticamente os redirecionamentos listados nos parâmetros query+titles, query+pageids e query+revids, e nas páginas devolvidas por query+generator.
- Tipo: booliano (detalhes)
- converttitles
Converter os títulos noutras variantes de língua, se necessário. Só funciona se a língua de conteúdo da wiki suporta a conversão entre variantes. As línguas que suportam conversão entre variantes incluem ban, en, crh, gan, iu, ku, mni, sh, shi, sr, tg, tly, uz, wuu, zgh e zh.
- Tipo: booliano (detalhes)
- Obter informação do site e as revisões da página Wikisource:Página principal.
- api.php?action=query&prop=revisions&meta=siteinfo&titles=Wikisource%3AP%C3%A1gina%20principal&rvprop=user|comment&continue= [abrir na página de testes]
- Obter as revisões das páginas que começam por API/.
- api.php?action=query&generator=allpages&gapprefix=API/&prop=revisions&continue= [abrir na página de testes]