API:Query/es

El módulo  te permite obtener información sobre un wiki y los datos almacenados en él, como el wikitext de una página en particular, los enlaces y categorías de un conjunto de páginas, o el token que necesitas para .

Módulos de consulta
El módulo de consulta tiene tres tipos de submódulos (también llamados módulos de consulta):


 * sobre la wiki y el usuario conectado.
 * de páginas, incluidas las revisiones de página y el contenido.
 * de páginas que coinciden con ciertos criterios.

Ejemplo 1: Especificando páginas
A diferencia de los módulos de consulta meta y lista, todos los módulos de consulta de propiedades funcionan en un conjunto de páginas que se pueden especificar de una de las siguientes maneras:


 * Por nombre usando el parámetro, p.ej.,.
 * Por ID de página usando el parámetro, p.ej.,.
 * Por ID de revisión utilizando el parámetro, p.ej.,  . La mayoría de los módulos de consulta convertirán la ID de revisión a la ID de página correspondiente. Solo  usa actualmente la ID de revisión en sí.
 * Utilizando un generator.

Ejemplo 2: Normalización de título
Normalización de títulos convierte títulos de páginas a su forma canónica.

Esto significa poner en mayúscula el primer carácter, reemplazar los guiones bajos con espacios y cambiar el espacio de nombres a la forma localizada definida para esa wiki.

Ejemplo 3: títulos Desaparecidos y nulos
Los títulos que no existan o que no sean válidos tendrán un atributo de  o   establecido en la respuesta.

En formatos de salida que admitan claves de matriz numéricas, los títulos faltantes e inválidos tendrán 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.

Ejemplo 4: consultas continuas
Cuando todo el dato no se devuelva en la respuesta de una consulta, habrá un atributo  para indicar que hay más dato.

Respuesta
Para obtener más datos, agregue sus valores a la solicitud original.

Ejemplo 5: Batchcomplete
La API devuelve un elemento  para indicar que todo el dato para el lote actual de artículos ha sido devuelto.

En la respuesta de la consulta de muestra anterior, se ha incluido  para indicar que se ha devuelto todo el dato de cada una de las tres imágenes.

La próxima continuación comenzará devolver dato para el siguiente conjunto de 3 imágenes.

Ejemplo 6: Generators
Usa generadores si deseas obtener datos sobre un conjunto de páginas

Por ejemplo, para obtener datos sobre páginas en una determinada categoría, en lugar de consultar  y luego consultar nuevamente con   configurado en todas las páginas devueltas, combine las dos llamadas API en una utilizando.

Cuando utilices un módulo de lista como un generador, no necesitas especificar las páginas.

Sin embargo, para un módulo de propiedades, debes specify the pages en las que trabajará el generador.

Por ejemplo, para cargar todas las páginas que estén vinculadas desde la página principal, usa.

Los parámetros pasados ​​a un generador deben tener el prefijo. Por ejemplo, cuando uses , usa  en lugar de.

La consulta de muestra abajo, obtiene enlaces y categorías para las primeras tres páginas en el espacio de nombres principal que comiencen con "Ba".

Historial de parámetros

 * v1.21: Introducido
 * v1.24: Introducido  (nota raw continuation era el comportamiento por defecto hasta v1.26)

Notas adicionales

 * Especificar títulos a través de  o   está limitado a 50 títulos por consulta, o 500 para aquellos con el derecho.
 * Usa múltiples módulos de consulta juntos para obtener lo que necesites en una solicitud, p.ej.,.
 * 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.

Resolviendo redirecciones
Las redirecciones se pueden resolver automáticamente, de modo que se devuelva el objetivo de una redirección en lugar del título dado. Cuando estén presentes, siempre contendrán atributos  y   y pueden contener un atributo   para los redireccionamientos que apuntan a secciones específicas.

Normalización y redirección, ambas pueden tener lugar. En el caso de múltiple redirecciones, todas serán resueltas, y en caso de una redirección circular, no podría haber una página en la sección de 'pages' sección (ve también below). La resolución de redireccionamiento no se puede usar en combinación con el parámetro  o con un generador que genere revids; hacer eso producirá un advertencia y no resolverá los redireccionamientos para los revids especificados.

Los ejemplos siguientes muestran cómo funciona el parámetro.

Véase también

 * - La guía de inicio rápida.
 * - Contiene información sobre como usar el parámetro.