API:Listen

From mediawiki.org
This page is a translated version of the page API:Lists and the translation is 100% complete.

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:

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 im query-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 ein limits-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 dass ptlimit die maximale Anzahl der zurückgegebenen protectedtitles und cmlimit die maximale Anzahl der zurückgegebenen categorymembers ist.

Siehe auch