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 .



API Documentación


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.

Ejemplos


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.



Respuesta


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.



Respuesta


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.



Respuesta


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.

Response


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.



Respuesta


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".



Continuing queries
Queries will often have more results available than are just shown in the original query. (Often this is because a List query's result limit has been reached.) In these cases, queries can be continued. More detailed information on continuing queries can be at API:Continue.



Avisos posibles


Historial de parámetros

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

<span id="Additional_notes">

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.

<span id="Resolving_redirects">

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.

<span id="See_also">

Véase también

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