API:Query - Lists/de

From MediaWiki.org

Diese Seite ist Teil der deutschen Übersetzung der MediaWiki-API-Dokumentation.

Sprache:

English  • Deutsch  • Español  • 日本語

Diese Seite wird noch weiter übersetzt, die Dokumentation ist derzeit nicht vollständig

Listen unterscheiden sich von Eigenschaften dahingehend, dass sie jeweils eigene Ergebnis-Abschnitte im query-Block liefern anstatt das pages-Element zu erweitern. Zusätzlich schränken die Begrenzungen die Anzahl der zurückgegebenen Elemente ein, die Abfragen können aber fortgesetzt werden. Sofern nicht anders angegeben sind alle Listen-Module als Generator einsetzbar.

[edit] allpages / ap

Liefert eine Liste aller Seiten im gegebenen Namensbereich (mit den entsprechenden Eigenschaften)

[edit] Parameter

• apfrom: Starte die Titelliste bei diesem Titel (muss nicht existieren)
• apprefix: Liste nur Titel auf, die mit diesem Präfix beginnen
• apnamespace: Liste nur Titel aus diesem Namensraum auf (nur ein Namensraum erlaubt, Standard ist 0, also Artikel)
• apfilterredir: Wie werden Weiterleitungen behandelt?
  • all: Liste alle gefundenen Seiten, egal ob es Weiterleitungen sind oder nicht (Standard)
  • redirects: Liste nur Weiterleitungen
  • nonredirects: Liste keine Weiterleitungen
• apfilterlanglinks: Filtere Seiten anhand der Existenz von Interwiki - Linkslanguage links
  • all: Liste alle Seiten, egal ob sie Interwiki-Sprachlinks haben (Standard)
  • withlanglinks: Liste nur Seiten mit Interwiki-Sprachlinks
  • withoutlanglinks: Liste nur Seiten ohne Interwiki-Sprachlinks
• apminsize: Liste nur Seiten mit mindestens dieser Größe (in Byte)
• apmaxsize: Liste nur Seiten mit höchstens dieser Größe (in Byte)
• apprtype: Liste nur Seiten mit der gegebenen Schutzart
  • edit: Schreibgeschützte Seiten
  • move: Verschiebe-geschützte Seiten
  • Andere Wikis können weitere Schutzarten definieren und somit weitere Schlüsselwerte erlauben
• apprlevel: Liste nur Seiten auf mit der gegebenen Schutzstufe (nicht benutzbar ohne apprtype)
  • autoconfirmed: Nur "automatisch bestätigte" Benutzer können bearbeiten/verschieben/wasauchimmer
  • sysop: Nur Administratoren können bearbeiten/verschieben/wasauchimmer
  • Leer: Jeder kann bearbeiten/verschieben/wasauchimmer
  • Andere wikis können weitere Schutzstufen definieren und somit weitere gültige Werte bieten
• aplimit: Maximale Anzahl von Ergebnissen je Abfrage(Standard: 10)
• apdir: In welcher Sortierung sollen die Seiten gelistet werden?
  • ascending: Aufsteigend A - Z (Standard)
  • descending: Absteigend Z - A

[edit] Beispiel

Zeige die ersten 5 Titel, die mit "Kre" beginnen

<?xml version="1.0"?>
<api>
  <query-continue>
    <allpages apfrom="Kreatinkinase" />
  </query-continue>
  <query>
    <allpages>
      <p pageid="2039056" ns="0" title="Kreanga" />
      <p pageid="1377016" ns="0" title="Kreatianismus" />
      <p pageid="377635" ns="0" title="Kreatin" />
      <p pageid="982767" ns="0" title="Kreatin-Phosphat" />
      <p pageid="135179" ns="0" title="Kreatinin" />
    </allpages>
  </query>
</api>

[edit] Nutzung als Generator

Zeige Informationen zu den ersten 5 Titeln, die mit "Kre" beginnen

<?xml version="1.0"?>
<api>
  <query-continue>
    <allpages gapfrom="Kreatinkinase" />
  </query-continue>
  <query>
    <pages>
      <page pageid="2039056" ns="0" title="Kreanga" touched="2008-09-23T12:58:35Z" lastrevid="24802115" counter="0" length="31" redirect="" new="" />
      <page pageid="1377016" ns="0" title="Kreatianismus" touched="2008-09-18T16:56:48Z" lastrevid="45165075" counter="0" length="1686" />
      <page pageid="377635" ns="0" title="Kreatin" touched="2008-09-14T19:58:23Z" lastrevid="50564225" counter="0" length="9085" />
      <page pageid="982767" ns="0" title="Kreatin-Phosphat" touched="2008-09-09T19:45:07Z" lastrevid="9914576" counter="0" length="21" redirect="" new="" />
      <page pageid="135179" ns="0" title="Kreatinin" touched="2008-09-18T18:20:06Z" lastrevid="50895011" counter="0" length="5318" />
    </pages>
  </query>
</api>

[edit] Mögliche Fehler

• code: apparams
  • info: Use "gapfilterredir=nonredirects" option instead of "redirects" when using allpages as a generator
  • Deutsch: Wenn allpages als Generator benutzt wird, muss "gapfilterredir=nonredirects" anstelle des "redirects"-Parameter verwendet werden
• code: apparams
  • info: prlevel may not be used without prtype
  • Deutsch: prlevel darf nicht ohne prtype verwendet werden