API:Lists/fr
Cette page fait partie de la documentation de l'API MediaWiki Action. |
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 :
- allcategories
- alldeletedrevisions
- allfileusages
- allimages
- alllinks
- allpages
- allredirects
- allrevisions
- alltransclusions
- allusers
- backlinks
- blocks
- categorymembers
- deletedrevs
- embeddedin
- exturlusage
- filearchive
- imageusage
- iwbacklinks
- langbacklinks
- logevents
- pagepropnames
- pageswithprop
- prefixsearch
- protectedtitles
- querypage
- random
- recentchanges
- search
- tags
- usercontribs
- users
- watchlist
- watchlistraw
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émentlimits
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
, doncptlimit
est le nombre maximum parmiprotectedtitles
retourné, etcmlimit
est le nombre maximum parmicategorymembers
retourné.
- La limite des résultats peut être fixée à 500 pour les utilisateurs classiques, ou 5000 pour ceux qui ont le droit
Voir aussi
- Maintenu par MediaWiki Interfaces Team.
- Discussion en direct (IRC): #mediawiki-core connecter
- Suivi des problèmes : Phabricator MediaWiki-Action-API (rapporter un problème)