API:Listen
Appearance
Outdated translations are marked like this.
| 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 dassptlimitdie maximale Anzahl der zurückgegebenenprotectedtitlesundcmlimitdie maximale Anzahl der zurückgegebenencategorymembersist.
- 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)