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
Módulo principal
- Fonte: MediaWiki
- Licença: GPL-2.0-or-later
Estado: A API do MediaWiki é uma interface consolidada e estável que é constantemente suportada e melhorada. Embora tentemos evitá-lo, podemos ocasionalmente realizar alterações disruptivas. Inscreva-se na lista de distribuição mediawiki-api-announce para receber notificações das atualizações.
Pedidos incorretos: Quando são enviados pedidos incorretos à API, será devolvido um cabeçalho HTTP com a chave "MediaWiki-API-Error" e depois tanto o valor desse cabeçalho como o código de erro devolvido serão definidos com o mesmo valor. Para mais informação, consulte API:Erros e avisos.
Testes: Para testar facilmente pedidos à API, visite Testes da API.
- action
A operação a ser realizada.
- abusefiltercheckmatch
- Verificar se um filtro de abusos coincide com um conjunto de variáveis, uma edição, ou um evento do registo de abusos.
- abusefilterchecksyntax
- Verificar a sintaxe de um filtro de abusos.
- abusefilterevalexpression
- Avalia uma expressão do filtro de abusos.
- abusefilterunblockautopromote
- Desbloqueia um utilizador de receber autopromoções em consequência do filtro de abusos.
- addstudents
- Adicionar vários alunos a um curso.
- antispoof
- Verificar um nome de utilizador contra as verificações de normalização do AntiSpoof.
- block
- Bloquear um utilizador.
- bouncehandler
- Receber um correio de devolução e processá-lo, para lidar com o erro de destinatário.
- categorytree
- Módulo interno para a extensão "Árvore de categorias" (CategoryTree).
- centralauthtoken
- Obter uma chave centralauthtoken para fazer um pedido autenticado a uma wiki anexada.
- centralnoticecdncacheupdatebanner
- Pedir a purga do conteúdo de modelos armazenado na cache CDN (cliente) para utilizadores anónimos, para o modelo e língua pedidos
- centralnoticechoicedata
- Obter dados necessários para escolher o modelo de um determinado projeto e língua.
- centralnoticequerycampaign
- Obter todas as configurações de um aviso.
- changeauthenticationdata
- Alterar os dados de autenticação do utilizador atual.
- checktoken
- Verificar a validade de uma chave a partir de action=query&meta=tokens.
- cirrus-config-dump
- Cópia em ficheiro da configuração do CirrusSearch.
- cirrus-mapping-dump
- Cópia em ficheiro do mapeamento do CirrusSearch para esta wiki.
- cirrus-settings-dump
- Cópia em ficheiro das configurações do CirrusSearch para esta wiki.
- clearhasmsg
- Limpa a indicação
hasmsgdo utilizador atual. - clientlogin
- Entrar na wiki usando o processo interativo.
- compare
- Obter a diferença entre duas páginas.
- createaccount
- Criar uma conta de utilizador nova.
- cspreport
- Usado por browsers para reportar violações da norma "Content Security Policy". Este módulo nunca deve ser usado, exceto quando utilizado automaticamente por um browser compatível com a CSP.
- cxconfiguration
- Obter a configuração json do Tradutor de Conteúdo para o par de línguas especificado.
- cxdelete
- Apagar o rascunho de uma tradução criada usando a extensão Tradutor de Conteúdo.
- cxpublish
- Gravar uma página criada usando a extensão Tradutor de Conteúdo.
- cxsave
- Este módulo permite gravar rascunhos de traduções por secção para poupar largura de banda e coligir corpora paralelos.
- cxsuggestionlist
- Administrar as listas de sugestões. Adicionar sugestões às listas e removê-las.
- cxtoken
- Obter chaves JWT para se autenticar com o cxserver.
- delete
- Eliminar uma página.
- deleteeducation
- Eliminar objetos do Programa Educativo.
- deleteglobalaccount
- Eliminar um utilizador global.
- echomarkread
- Marcar notificações como lidas para o utilizador atual.
- echomarkseen
- Marcar as notificações como vistas pelo utilizador atual.
- edit
- Criar e editar páginas.
- editmassmessagelist
- Editar uma lista de entrega de mensagens em massa.
- emailuser
- Enviar correio eletrónico a um utilizador.
- enlist
- Associar ou desassociar um utilizador como professor ou voluntário de um curso.
- expandtemplates
- Expande todas as predefinições existentes num texto wiki.
- fancycaptchareload
- Gerar novo FancyCaptcha.
- featuredfeed
- Devolve um feed de conteúdos em destaque.
- feedcontributions
- Devolve um feed das contribuições do utilizador.
- feedrecentchanges
- Devolve um feed das mudanças recentes.
- feedwatchlist
- Devolve um feed das páginas vigiadas.
- filerevert
- Reverter um ficheiro para uma versão antiga.
- flagconfig
- Obter informações de base sobre a configuração dos marcadores automáticos deste sítio.
- flow
- Permite que sejam realizadas ações nas páginas que utilizam o Flow.
- flow-parsoid-utils
- Converter texto entre texto wiki e HTML.
- flowthank
- Enviar notificação de agradecimento público por um comentário no Flow.
- globalblock
- Bloquear ou desbloquear globalmente um utilizador.
- globalpreferenceoverrides
- Alterar as sobreposições locais das preferências globais do utilizador corrente.
- globalpreferences
- Alterar as preferências globais do utilizador atual.
- globaluserrights
- Adicionar ou remover um utilizador, de grupos globais.
- graph
- Aceder à funcionalidade do elemento
graph. - help
- Apresentar ajuda para os módulos especificados.
- imagerotate
- Este módulo foi desativado.
- import
- Importar uma página de outra wiki ou de um ficheiro XML.
- jsonconfig
- Permite o acesso direto ao subsistema JsonConfig.
- jsondata
- Obter os dados JSON localizados.
- languagesearch
- Pesquisar nomes de línguas em qualquer sistema de escrita.
- linkaccount
- Ligar uma conta de um fornecedor terceiro ao utilizador atual.
- liststudents
- Obter os nomes de utilizador e outras informações para os alunos matriculados num ou mais cursos.
- login
- Iniciar uma sessão e obter cookies de autenticação.
- logout
- Terminar a sessão e limpar os dados da sessão.
- managetags
- Executar tarefas de gestão relacionadas com etiquetas de modificação.
- massmessage
- Enviar uma mensagem para uma lista de páginas.
- mergehistory
- Fundir o historial de páginas.
- mobileview
- Devolve os dados necessários para o visionamento em dispositivos móveis.
- move
- Mover uma página.
- oathvalidate
- Validar uma chave de autenticação de dois fatores (OATH).
- opensearch
- Pesquisar a wiki usando o protocolo OpenSearch.
- options
- Alterar as preferências do utilizador atual.
- paraminfo
- Obter informação sobre os módulos da API.
- parse
- Faz a análise sintática do conteúdo e devolve o resultado da análise.
- parser-migration
- Fazer a análise sintática de uma página com duas configurações diferentes.
- parsoid-batch
- API em segundo plano (batch API) para Parsoid
- patrol
- Patrulhar uma página ou revisão.
- protect
- Alterar o nível de proteção de uma página.
- purge
- Limpar a cache para os títulos especificados.
- query
- Obter dados de, e sobre, o MediaWiki.
- readinglists
- Operações de escrita das listas de leitura.
- record-lint
- Registar um erro de lint na base de dados
- refresheducation
- Reconstruir os dados resumo dos objetos do Programa Educativo.
- removeauthenticationdata
- Remover os dados de autenticação do utilizador atual.
- resetpassword
- Enviar a um utilizador uma mensagem eletrónica de reinício da palavra-passe.
- review
- Rever uma revisão, aprovando-a ou anulando a sua aprovação.
- reviewactivity
- Anunciar, ou deixar de anunciar, que está a rever uma página que não foi revista ou tem alterações não revistas.
- revisiondelete
- Eliminar e restaurar revisões.
- rollback
- Desfazer a última edição da página.
- rsd
- Exportar um esquema (schema) RSD (Really Simple Discovery).
- sanitize-mapdata
- Realiza a validação de dados para a extensão Kartographer
- scribunto-console
- Módulo interno para responder a pedidos XHR vindos da consola Scribunto.
- setglobalaccountstatus
- Definir o estado de um utilizador global.
- setnotificationtimestamp
- Atualizar a data e hora de notificação de alterações às páginas vigiadas.
- setpagelanguage
- Alterar a língua de uma página.
- shortenurl
- Reduzir um URL longo para um mais curto.
- sitematrix
- Obter a lista de sítios Wikimedia.
- spamblacklist
- Validar um ou mais URL contra a lista negra de spam.
- stabilize
- Configurar as definições de proteção por revisão de uma página.
- stashedit
- Preparar uma edição na cache partilhada.
- strikevote
- Permite que os administradores anulem ou desfaçam a anulação de um voto.
- tag
- Adicionar ou remover as etiquetas de modificação aplicadas a revisões individuais ou a entradas do registo.
- templatedata
- Obtém dados armazenados pela extensão TemplateData.
- thank
- Enviar uma notificação de agradecimento a um editor.
- titleblacklist
- Validar um título de página, nome de ficheiro ou nome de utilizador contra a lista negra.
- transcodereset
- Os utilizadores com o privilégio 'transcode-reset' podem reiniciar e voltar a executar uma tarefa de transcodificação.
- ulslocalization
- Obter a localização de ULS na língua indicada.
- unblock
- Desbloquear um utilizador.
- undelete
- Restaurar revisões de uma página eliminada.
- unlinkaccount
- Remover do utilizador atual uma conta ligada de uma wiki terceira.
- upload
- Carregar um ficheiro, ou obter o estado dos carregamentos pendentes.
- userrights
- Alterar os grupos a que um utilizador pertence.
- validatepassword
- Validar uma palavra-passe face às regras para palavras-passe da wiki.
- visualeditor
- Devolve o HTML5 para uma página a partir do serviço Parsoid.
- visualeditoredit
- Gravar no MediaWiki uma página HTML5 (convertida para texto wiki através do serviço Parsoid).
- watch
- Adicionar ou remover páginas da lista de páginas vigiadas do utilizador atual.
- webapp-manifest
- Devolve um manifesto de aplicação da Internet.
- wikilove
- Envie um WikiApreço a outro utilizador.
- zeroconfig
- Obter a configuração da extensão Zero.
- tokens
- Obsoleto. Obter chaves para operações de modificação de dados.
- Um dos seguintes valores: abusefiltercheckmatch, abusefilterchecksyntax, abusefilterevalexpression, abusefilterunblockautopromote, addstudents, antispoof, block, bouncehandler, categorytree, centralauthtoken, centralnoticecdncacheupdatebanner, centralnoticechoicedata, centralnoticequerycampaign, changeauthenticationdata, checktoken, cirrus-config-dump, cirrus-mapping-dump, cirrus-settings-dump, clearhasmsg, clientlogin, compare, createaccount, cspreport, cxconfiguration, cxdelete, cxpublish, cxsave, cxsuggestionlist, cxtoken, delete, deleteeducation, deleteglobalaccount, echomarkread, echomarkseen, edit, editmassmessagelist, emailuser, enlist, expandtemplates, fancycaptchareload, featuredfeed, feedcontributions, feedrecentchanges, feedwatchlist, filerevert, flagconfig, flow, flow-parsoid-utils, flowthank, globalblock, globalpreferenceoverrides, globalpreferences, globaluserrights, graph, help, imagerotate, import, jsonconfig, jsondata, languagesearch, linkaccount, liststudents, login, logout, managetags, massmessage, mergehistory, mobileview, move, oathvalidate, opensearch, options, paraminfo, parse, parser-migration, parsoid-batch, patrol, protect, purge, query, readinglists, record-lint, refresheducation, removeauthenticationdata, resetpassword, review, reviewactivity, revisiondelete, rollback, rsd, sanitize-mapdata, scribunto-console, setglobalaccountstatus, setnotificationtimestamp, setpagelanguage, shortenurl, sitematrix, spamblacklist, stabilize, stashedit, strikevote, tag, templatedata, thank, titleblacklist, transcodereset, ulslocalization, unblock, undelete, unlinkaccount, upload, userrights, validatepassword, visualeditor, visualeditoredit, watch, webapp-manifest, wikilove, zeroconfig, tokens
- Valor por omissão: help
- format
O formato do resultado.
- json
- Produzir os dados de saída no formato JSON.
- jsonfm
- Produzir os dados de saída em formato JSON (realce sintático em HTML).
- none
- Não produzir nada.
- php
- Produzir os dados de saída em formato PHP seriado.
- phpfm
- Produzir os dados de saída em formato PHP seriado (realce sintático em HTML).
- rawfm
- Produzir os dados de saída, incluindo elementos para despiste de erros, em formato JSON (realce sintático em HTML).
- xml
- Produzir os dados de saída em formato XML.
- xmlfm
- Produzir os dados de saída em formato XML (realce sintático em HTML).
- Um dos seguintes valores: json, jsonfm, none, php, phpfm, rawfm, xml, xmlfm
- Valor por omissão: jsonfm
- maxlag
O atraso máximo pode ser usado quando o MediaWiki é instalado num cluster de bases de dados replicadas. Para impedir que as operações causem ainda mais atrasos de replicação do sítio, este parâmetro pode fazer o cliente aguardar até que o atraso de replicação seja inferior ao valor especificado. Caso o atraso atual exceda esse valor, o código de erro maxlag é devolvido com uma mensagem como À espera do servidor $host: $lag segundos de atraso.
Consulte Manual: Parâmetro maxlag para mais informações.- Tipo: inteiro
- smaxage
Definir no cabeçalho HTTP
s-maxagede controlo da cache este número de segundos. Os erros nunca são armazenados na cache.- Tipo: inteiro
- Valor por omissão: 0
- maxage
Definir no cabeçalho HTTP
max-agede controlo da cache este número de segundos. Os erros nunca são armazenados na cache.- Tipo: inteiro
- Valor por omissão: 0
- assert
Se definido com o valor user, verificar que o utilizador está autenticado. Se definido com o valor bot, verificar que o utilizador tem o privilégio de conta robô.
- Um dos seguintes valores: user, bot
- assertuser
Verificar que o utilizador atual é o utilizador nomeado.
- Tipo: nome de utilizador
- requestid
Qualquer valor fornecido aqui será incluído na resposta. Pode ser usado para distinguir pedidos.
- servedby
Incluir nos resultados o nome do servidor que serviu o pedido.
- Tipo: booliano (detalhes)
- curtimestamp
Incluir a data e hora atuais no resultado.
- Tipo: booliano (detalhes)
- responselanginfo
Incluir as línguas usadas para uselang e errorlang no resultado.
- Tipo: booliano (detalhes)
- origin
Ao aceder à API usando um pedido AJAX entre domínios (CORS), coloque aqui o domínio de origem. Isto tem de ser incluído em todas as verificações prévias e, portanto, tem de fazer parte do URI do pedido (e não do conteúdo do POST).
Para pedidos autenticados, este valor tem de corresponder de forma exata a um dos cabeçalhos
Origin, portanto, tem de ser algo como https://en.wikipedia.org ou https://meta.wikimedia.org. Se este parâmetro não for igual ao cabeçalhoOrigin, será devolvida a resposta 403. Se este parâmetro for igual ao cabeçalhoOrigine a origem for permitida (white-listed) os cabeçalhosAccess-Control-Allow-OrigineAccess-Control-Allow-Credentialsserão preenchidos.Para pedidos não autenticados, especifique o valor *. Isto fará com que o cabeçalho
Access-Control-Allow-Originseja preenchido, masAccess-Control-Allow-Credentialsterá o valorfalsee o acesso a todos os dados específicos do utilizador está restringido.- uselang
A língua a ser usada nas traduções de mensagens. action=query&meta=siteinfo com siprop=languages devolve uma lista de códigos de língua, ou especifique user para usar a língua nas preferências do utilizador atual, ou especifique content para usar a língua de conteúdo desta wiki.
- Valor por omissão: user
- errorformat
O formato a ser usado no texto de avisos e erros.
- plaintext
- Texto wiki com os elementos HTML removidos e as entidades substituídas.
- wikitext
- Texto wiki sem análise sintática.
- html
- HTML.
- raw
- Chave e parâmetros da mensagem.
- none
- Sem saída de texto, só os códigos de erro.
- bc
- Formato usado antes do MediaWiki 1.29. errorlang e errorsuselocal são ignorados.
- Um dos seguintes valores: plaintext, wikitext, html, raw, none, bc
- Valor por omissão: bc
- errorlang
A língua a ser usada para avisos e erros. action=query&meta=siteinfo com siprop=languages devolve uma lista de códigos de língua, ou especifique content para usar a língua de conteúdo desta wiki, ou especifique uselang para usar o mesmo valor que o parâmetro uselang.
- Valor por omissão: uselang
- errorsuselocal
Se fornecido, os textos de erro utilizarão mensagens personalizadas localmente do espaço nominal MediaWiki.
- Tipo: booliano (detalhes)
- centralauthtoken
Ao aceder à API usando um pedido AJAX entre domínios (CORS), use este parâmetro para se autenticar como o utilizador SUL atual. Use action=centralauthtoken nesta wiki para obter a chave, antes de efetuar o pedido CORS. Cada chave só pode ser usada uma vez e expira após 10 segundos. Isto tem de ser incluído em todas as verificações prévias, e portanto tem de fazer parte do URI do pedido (e não do conteúdo do POST).
- Ajuda para o módulo principal.
- api.php?action=help [abrir na página de testes]
- Toda a ajuda numa página.
- api.php?action=help&recursivesubmodules=1 [abrir na página de testes]
Tipo de dados
O formato de entrada para o MediaWiki deve ser UTF-8, normalizado de acordo com a norma NFC. O MediaWiki pode converter outros tipos de entrada, mas esta conversão pode originar a falha de algumas operações (tais como as edições com verificações MD5).
Alguns tipos de parâmetros nos pedidos à API necessitam de mais explicações:
- boolean
- Os parâmetros boolianos funcionam como as caixas de seleção HTML: se o parâmetro for especificado, independentemente do seu valor, é considerado verdadeiro. Para um valor falso, omitir o parâmetro completo.
- timestamp
- As datas e horas podem ser especificadas em vários formatos. É recomendado o formato ISO 8601. Todas as horas estão em UTC, qualquer inclusão do fuso horário é ignorada.
- Data e hora ISO 8601, 2001-01-15T14:56:00Z (pontuação e Z são opcionais)
- Data e hora ISO 8601 com segundos fracionários (estes são ignorados), 2001-01-15T14:56:00.00001Z (traços, dois pontos e Z são opcionais)
- Formato do MediaWiki, 20010115145600
- Formato numérico genérico, 2001-01-15 14:56:00 (fuso horário opcional GMT, +##, ou -## são ignorados)
- Formato EXIF, 2001:01:15 14:56:00
- Formato RFC 2822 (o fuso horário pode ser omitido), Mon, 15 Jan 2001 14:56:00
- Formato RFC 850 (o fuso horário pode ser omitido), Monday, 15-Jan-2001 14:56:00
- Formato C ctime, Mon Jan 15 14:56:00 2001
- Segundos desde 1970-01-01T00:00:00Z como um inteiro de 1 a 13 algarismos (excluindo 0)
- O texto now
- separador alternativo de valores múltiplos
- Os parâmetros que aceitam vários valores são normalmente fornecidos com os valores separados por uma barra vertical (pipe), por exemplo parâmetro=valor1|valor2 ou parâmetro=valor1%7Cvalor2. Se um valor contém a barra vertical, use como separador o U+001F (Separador de Unidades) e prefixe o valor com U+001F, isto é, parâmetro=%1Fvalor1%1Fvalor2.
Parâmetros modelados
Os parâmetros modelados usam-se nos casos em que um módulo da API necessita de um valor para cada valor de um outro parâmetro. Por exemplo, se existisse um módulo da API para encomendar fruta, poderia ter um parâmetro frutas para especificar as frutas que estão a ser encomendadas e um parâmetro modelado quantidade-de-{fruta} para especificar quanto de cada fruta. Um cliente da API que pretenda 1 maçã, 5 bananas e 20 morangos pode então fazer um pedido como frutas=maçãs|bananas|morangos&quantidade-de-maçãs=1&quantidade-de-bananas=5&quantidade-de-morangos=20.
Créditos
Programadores da API:
- Yuri Astrakhan (criador, programador principal, set 2006–set 2007)
- Roan Kattouw (programador principal, set 2007–2009)
- Victor Vasiliev
- Bryan Tong Minh
- Sam Reed
- Brad Jorsch (programador principal, 2013–presente)
Pode enviar os seus comentários, sugestões e perguntas para o endereço mediawiki-api@lists.wikimedia.org, ou reportar quaisquer defeitos que encontre em https://phabricator.wikimedia.org/.