Jump to content

API:Listas

From mediawiki.org
This page is a translated version of the page API:Lists and the translation is 94% complete.
Outdated translations are marked like this.

Solicitud GET para listar elementos que coincidan con criterios de selección.

API Documentación

Las listas generalmente devuelven agregaciones de datos, como páginas recopiladas de un wiki o enlaces recopilados en una sola página. Para solicitar una lista, pasa el parámetro list de tu cadena de consulta a un submódulo de lista válido, como allimages o usercontribs.

Para usar la lista API, especifica action=query&list=list1|list2 en la URL.

Ver páginas lista individual API para ejemplos más concretos de cómo para utilizar listas:

Notas adicionales

  • La mayoría de submódulos de la lista se pueden usar como generadores , a menos que se indique lo contrario.
  • Las listas difieren de properties en que, en lugar de agregar datos a los elementos, en el elemento pages, cada lista tiene su propia rama separada en el elemento query.
  • Límites de consulta de lista:
    • El límite de resultados se puede establecer hasta $500 para usuarios regulares, o $5000 para usuarios con el derecho apihighlimits (generalmente bots y sysops).
    • Algunos módulos imponen límites más estrictos bajo ciertas condiciones. Ver esta subpágina para más detalles.
    • Si no estás seguro de qué límite se te aplica y solo deseas tantos resultados como sean posibles, establece el límite en max. En ese caso, se devolverá un elemento $limit, especificando los límites utilizados.
    • El parámetro límite para un módulo dado consiste en el prefijo del módulo seguido de limit, por lo que ptlimit es el número máximo de protectedtitles devueltos y cmlimit es el número máximo de categorymembers devueltos.

Véase también