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
Very often you will not get all the data you want in one API query. When that happens the API result indicates there is more data.

Because there are more data matching the query, the API result includes a  element. If you want further data, you would add its values (in the example,  and  ) to the original request to get the next set of results. You continue to do this until an API result does not have a  element, indicating there are no more data matching the query.

Here is Python code showing how to iterate over query results (using the python requests lib). Note you should not manipulate or depend on any specifics of the values returned inside the  element, as they may change.

batchcomplete
When you make an API request using a generator together with properties, the API result may signal to continue because there are more properties to retrieve for the pages so far, or because there are more pages from the generator, or both. From version 1.25 onwards, the API returns a  element to indicate that all data for the current "batch" of pages has been returned. This can be useful to avoid building a combined result set for thousands of pages when using a generator together with prop modules that may themselves need continuation.

Backwards compatibility of continue
From MediaWiki 1.21 to 1.25, it was required to specify  (i.e. with an empty string as the value) in the initial request to get continuation data in the format described above. Without doing that, API results would indicate there is additional data by returning a  element, explained in Raw query continue. Prior to 1.21, that raw continuation was the only option.

If your application needs to use the raw continuation in MediaWiki 1.26 or later, you must specify  to request it.



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.