Jump to content

API:Lists/fr

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

Requête GET pour lister les éléments qui correspondent au critère de sélection.

Documentation de l'API

Les listes retournent généralement des aggrégations de données, comme des pages rassemblées au travers d'un wiki, ou liées ensemble dans une page unique. Pour demander une liste, passer dans le paramètre list de votre chaîne de requête un sous-module de liste valide, tel que allimages ou usercontribs.

Pour utiliser l'API liste, précisez action=query&list=list1|list2 dans l'URL.

Voir les pages individuelles de l'API liste pour des exemples plus concrets sur la manière d'utiliser les listes :

Notes additionnelles

  • La plupart des sous-modules des listes peuvent être utilisés comme générateurs , sauf indication contraire.

Les listes diffèrent des propriétés (properties ) sur le fait que, à la place d'ajouter des données aux éléments de la "partie" pages, chaque liste a sa propre branche séparée dans l'élément query.

  • Limites de la requête de liste :
    • La limite des résultats peut être fixée à 500 pour les utilisateurs classiques, ou 5000 pour ceux qui ont le droit apihighlimits (typiquement pour les robots et les administrateurs).
    • Certains modules imposent des limites plus strictes sous certaines conditions. Voir cette sous-page pour d'autres détails.
    • Si vous n'êtes pas sûr de quelle limite vous concerne et voulez simplement le plus grand nombre de résultats possible, définissez la limite à max. Dans ce cas, un élément limits sera retourné, spécifiant les limites utilisées.
    • Le paramètre de limite pour un module donné est constitué du préfixe du module suivi par limit, donc ptlimit est le nombre maximum parmi protectedtitles retourné, et cmlimit est le nombre maximum parmi categorymembers retourné.

Voir aussi