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.
- 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.
- coordinates
- Devolve as coordenadas das páginas fornecidas.
- 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.
- growthimagesuggestiondata
- Obter os dados de recomendação de imagem associados, se disponíveis
- 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.
- langlinkscount
- Obter o número de versões noutras línguas.
- 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
- pageimages
- Devolve informação sobre as imagens de uma página, tais como miniaturas e a presença de fotografias.
- 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).
- 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.
- flowinfo
- Obsoleto. Obter informações básicas das discussões estruturadas sobre uma página.
- 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, coordinates, deletedrevisions, duplicatefiles, extlinks, extracts, fileusage, globalusage, growthimagesuggestiondata, imageinfo, images, info, iwlinks, langlinks, langlinkscount, links, linkshere, mmcontent, pageimages, pageprops, pageterms, pageviews, redirects, revisions, stashimageinfo, templates, transcludedin, transcodestatus, videoinfo, wbentityusage, flowinfo, 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.
- contenttranslation
- Consultar traduções na base de dados do Tradutor de Conteúdo.
- contenttranslationcorpora
- Obter o texto da secção paralela para uma dada tradução. Ver também
list=cxpublishedtranslations
. São fornecidos diferentes formatos para acessos de grande volume. - contenttranslationlangtrend
- Consultar na base de dados do Tradutor de Conteúdo o número de traduções por período.
- contenttranslationstats
- Obter estatísticas do Tradutor de Conteúdo.
- contenttranslationsuggestions
- Obter listas de sugestões para o Tradutor de Conteúdo.
- cxpublishedtranslations
- Obter toda a informação sobre traduções publicadas.
- cxtranslatorstats
- Obter as estatísticas de tradução do utilizador indicado.
- 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.
- geosearch
- Devolve páginas que têm coordenadas que estão localizadas numa certa área.
- globalallusers
- Enumerar todos os utilizadores globais.
- globalblocks
- Listar todos os endereços IP bloqueados globalmente.
- globalgroups
- Enumerar todos os grupos globais.
- growthmentorlist
- Listar todos os mentores
- growthmentormentee
- Obter todos os mentorados atribuídos a um mentor específico
- growthstarredmentees
- Obter lista de mentorados destacados pelo mentor que está autenticado neste momento
- 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.
- 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.
- 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.
- growthtasks
- Interno. Obter recomendações de tarefas adequadas para principiantes.
- 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, contenttranslation, contenttranslationcorpora, contenttranslationlangtrend, contenttranslationstats, contenttranslationsuggestions, cxpublishedtranslations, cxtranslatorstats, embeddedin, exturlusage, filearchive, gadgetcategories, gadgets, geosearch, globalallusers, globalblocks, globalgroups, growthmentorlist, growthmentormentee, growthstarredmentees, imageusage, iwbacklinks, langbacklinks, linterrors, logevents, mostviewed, mystashedfiles, pagepropnames, pageswithprop, prefixsearch, protectedtitles, querypage, random, recentchanges, search, tags, usercontribs, users, watchlist, watchlistraw, wblistentityusage, wikisets, deletedrevs, growthtasks, 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.
- growthmenteestatus
- Consultar o estado de mentorado do utilizador atual; ver a documentação de action=growthsetmenteestatus para obter informação detalhada sobre os estados individuais.
- growthmentorstatus
- Consultar o estado de mentor do utilizador corrente
- languageinfo
- Devolver informações sobre as línguas disponíveis.
- linterstats
- Obter o número de erros de lint em cada categoria
- notifications
- Obter notificações à espera do utilizador atual.
- ores
- Devolver a configuração ORES e os dados modelo para esta wiki.
- 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.
- cxdeletedtranslations
- Interno. Obter o número das suas traduções publicadas que foram eliminadas.
- growthnextsuggestedtasktype
- Interno. Obter um tipo de tarefa sugerido para um utilizador tentar a seguir.
- 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, growthmenteestatus, growthmentorstatus, languageinfo, linterstats, notifications, ores, siteinfo, siteviews, tokens, unreadnotificationpages, userinfo, wikibase, cxdeletedtranslations, growthnextsuggestedtasktype, 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.
- contenttranslation
- Consultar traduções na base de dados do Tradutor de Conteúdo.
- contenttranslationsuggestions
- Obter listas de sugestões para o Tradutor de Conteúdo.
- 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.
- geosearch
- Devolve páginas que têm coordenadas que estão localizadas numa certa área.
- 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.
- 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.
- 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.
- growthtasks
- Interno. Obter recomendações de tarefas adequadas para principiantes.
- 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, contenttranslation, contenttranslationsuggestions, deletedrevisions, duplicatefiles, embeddedin, exturlusage, fileusage, geosearch, images, imageusage, iwbacklinks, langbacklinks, links, linkshere, mostviewed, pageswithprop, prefixsearch, protectedtitles, querypage, random, recentchanges, redirects, revisions, search, templates, transcludedin, watchlist, watchlistraw, wblistentityusage, growthtasks, 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, 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 Wikipedia:Página principal.
- api.php?action=query&prop=revisions&meta=siteinfo&titles=Wikip%C3%A9dia%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]