API:Listen
Diese Seite ist Teil der Dokumentation der MediaWiki action API. |
GET-Abfrage, um Objekte aufzulisten, die bestimmte Kriterien erfüllen.
API-Dokumentation
Listen geben grundsätzlich Zusammenstellungen von Daten aus, wie Seiten aus einem Wiki oder Links innerhalb einer Seite. Um eine Liste abzufragen, gib dem Parameter list
deiner Abfrage-Zeichenkette ein gültiges Listen-Submodul wie allimages
oder usercontribs
.
Um die Listen-API zu verwenden, spezifiziere action=query&list=list1|list2
in der URL.
Siehe bitte die individuellen Listen-API-Seiten für genauere Beispiele zur Nutzung von Listen:
- 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
Zusätzliche Anmerkungen
- Die meisten Listen-Submodule können als Generatoren genutzt werden, sofern nichts anderes angegeben ist.
- 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 imquery
-Element. - Limits für Listen-Abfragen:
- 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. Siehe diese Unterseite für weitere 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 einlimits
-Element zurückgegeben, das die verwendeten Limits spezifiziert. - Der Limit-Parameter für ein gegebenes Modul besteht aus dem Modul-Präfix gefolgt von
limit
, so dassptlimit
die maximale Anzahl der zurückgegebenenprotectedtitles
undcmlimit
die maximale Anzahl der zurückgegebenencategorymembers
ist.
- Das Ergebnislimit kann für Standarduser auf bis zu 500 gesetzt werden oder auf 5000 für Benutzer mit dem
Siehe auch
- Gewartet von MediaWiki Interfaces Team.
- Echtzeit-Chat (IRC): #mediawiki-core connect
- Problem-Tracker: Phabricator MediaWiki-Action-API (Problem melden)