API:Listas

From mediawiki.org
This page is a translated version of the page API:Lists and the translation is 100% complete.

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