API:Query/pt

O módulo  permite-lhe obter a informação sobre uma wiki e os dados guardados na mesma, tal como o texto wiki de uma página em particular, as hiperligações e as categorias de um conjunto de páginas, ou o código (token) que precisa para.

Módulos de consulta
O módulo de consulta tem três tipos de submódulos (também chamados módulos de consulta):


 * sobre a wiki e o usuário conectado.
 * de páginas, incluídas as revisões de página e o conteúdo.
 * de páginas que coincidem com certos critérios.

Exemplo 1: Especificar as páginas
A diferença dos módulos de consulta meta e lista, todos os módulos de consulta de propriedades funcionam num conjunto de páginas que se podem especificar de uma das seguintes maneiras:


 * Por nome usando o parâmetro $ 1, exemplo: $ 2.
 * Por ID usando o parâmetro $ 1, exemplo: $ 2.
 * Por revisão usando o parâmetro $ 1, exemplo: $ 2 . A maioria dos módulos de consulta converterão a VÃO de revisão à VÃO de página correspondente. Só $ 1 usa actualmente a vão de revisão em si.
 * Utilizar um gerador.

Exemplo 2: Normalização do título
Normalização de títulos converte títulos de páginas a sua forma canónica.

Isto significa pôr em maiúscula o primeiro carácter, substituir os guiões baixos com espaços e mudar o espaço de nomes à forma localizada definida para essa wiki.

Exemplo 3: Títulos inválidos e em falta
Os títulos que não existam ou que não sejam válidos terão um atributo de $ 1 ou $ 2 estabelecido na resposta.

Em formatos de saída que admitam chaves de matriz numéricas, os títulos faltantes e inválidos terão IDs de página negativas.

In some cases, a title can be viewed by a user but cannot be accessed by the API, such as pages that mirror content from another wiki. These titles will have a  attribute set in the response.

Exemplo 4: Continuar consultas
Quando todo o dado não volta na resposta de uma consulta, terá um atributo $ 1 para indicar que há mais dado.

Resposta
Para obter mais dados, agregue seus valores à solicitação original.

Exemplo 5: Batchcomplete
A API devolve um elemento $ 1 para indicar que todo o dado para o lote actual de artigos tem sido devolvido.

Na resposta da consulta de mostra anterior, incluiu-se $ 1 para indicar que se devolveu todo o dado da cada uma das três imagens.

A próxima continuação começará devolver dado para o seguinte conjunto de 3 imagens.

Exemplo 6: Geradores
Usa geradores se desejas obter dados sobre um conjunto de páginas

Por exemplo, para obter dados sobre páginas numa determinada categoria, em lugar de consultar $ 1 e depois consultar novamente com $ 2 configurado em todas as páginas devolvidas, combine as duas chamadas API numa utilizando $ 3.

Quando utilizes um módulo de lista como um gerador, não precisas especificar as páginas.

No entanto, para um módulo de propriedades, deves specify the pages nas que trabalhará o gerador.

Por exemplo, para carregar todas as páginas que estejam vinculadas desde a página principal, usa $ 1.

Os parâmetros passados ​​a um erador devem ter o prefixo g. Por exemplo, quando uses generator=backlinks, usa  em lugar de bllimit.

A consulta de mostra abaixo, obtém enlaces e categorias para as primeiras três páginas no espaço de nomes principal que comecem com "Ba".

Histórico de parâmetros

 * v1.21: Introduzido
 * v1.24: Introduzido  (note que a continuação raw era o comportamento predefinido até à v1.26)

Notas adicionais

 * Specifying titles through  or   is limited to 50 titles per query, or 500 for those with the   right.
 * Use multiple query modules together to get what you need in one request, e.g..
 * Generators always pass page titles to the query module. Unlike lists (which may include additional data by default), generators should not output any information themselves, unless when explicitly requested via the generator module's query parameters.

Resolving redirects
Redirects can be resolved automatically, so that the target of a redirect is returned instead of the given title. When present, they will always contain  and   attributes and may contain a   attribute for those redirects that point to specific sections.

Both normalization and redirection may take place. In the case of multiple redirects, all redirects will be resolved, and in case of a circular redirect, there might not be a page in the 'pages' section (see also below). Redirect resolution cannot be used in combination with the  parameter or with a generator generating revids; doing that will produce a warning and will not resolve redirects for the specified revids.

The examples below show how the  parameter works.

Consulte também

 * - O guia de início rápido.
 * - Contém informação sobre como utilizar o parâmetro.