API:Listen

From mediawiki.org
Jump to navigation Jump to search
This page is a translated version of the page API:Lists and the translation is 59% complete.
Other languages:
Deutsch • ‎English • ‎Türkçe • ‎dansk • ‎español • ‎français • ‎polski • ‎português • ‎română • ‎svenska • ‎русский • ‎українська • ‎العربية • ‎ไทย • ‎中文 • ‎文言 • ‎日本語 • ‎한국어

GET request to list items that match select criteria.

API-Dokumentation

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.

Um die Listen-API zu verwenden, spezifiziere action=query&list=list1|list2 in der URL.

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

Zusätzliche Anmerkungen

  • Most list submodules can be used as generators , unless otherwise noted.
  • Listen unterscheiden sich von properties in zwei Aspekten - statt Daten an die Elemente im pages-Element anzuhängen, hat jede Liste seinen eigenen separaten Branch im query-Element.
  • List query limits:
    • Das Ergebnislimit kann für Standarduser auf bis zu 500 gesetzt werden oder auf 5000 für Benutzer mit dem apihighlimits-Recht (typischerweise Bots und Admins).
    • Einige Module verhängen unter bestimmten Bedingungen striktere Limits. See this subpage for more details.
    • Wenn Du nicht sicher bist, welches Limit für Dich gilt und Du so viele Ergebnisse wie möglich erhalten willst, dann setze das Limit auf max. In diesem Fall wird ein limits-Element zurückgegeben, das die verwendeten Limits spezifiziert.
    • 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.

Siehe auch