API:Listy

From MediaWiki.org
Jump to navigation Jump to search
This page is a translated version of the page API:Lists and the translation is 18% complete.

Outdated translations are marked like this.
Other languages:
Deutsch • ‎English • ‎dansk • ‎español • ‎français • ‎polski • ‎română • ‎русский • ‎українська • ‎العربية • ‎ไทย • ‎中文 • ‎日本語 • ‎한국어

GET request to list items that match select criteria.

API documentation

Lists generally return aggregations of data, such as pages gathered from across a wiki, or links gathered within a single page. To request a list, pass the list parameter of your query string a valid list submodule, such as allimages or usercontribs.

To use the list API, specify action=query&list=list1|list2 in the URL.

See individual list API pages for more concrete examples of how to use lists:

Additional notes

  • Most list submodules can be used as generators , unless otherwise noted.

Listy różnią się od properties w dwóch aspektach - zamiast doklejania do elementów w elemencie pages, każda lista ma swoją własną odseparowaną gałąź w elemencie query.

  • List query limits:
    • Domyślnie wynosi 10 i może być ustawiony do 500 przez zwykłych użytkowników lub do 5000 dla użytkowników z uprawnieniem $apihighlimits (zazwyczaj boty i administratorzy).
    • Niektóre moduły narzucają surowsze limity w niektórych warunkach. See this subpage for more details.
    • Jeżeli nie jesteś pewien, jaki limit możesz wykorzystać i chcesz uzyskać tak dużo wyników jak to możliwe, ustaw wartość limitu na max. In that case, a limits element will be returned, specifying the limits used.
    • The limit parameter for a given module consists of the module prefix followed by limit, so ptlimit is the maximum number of protectedtitles returned, and cmlimit is the maximum number of categorymembers returned.

See also