API:Lists/de

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

MediaWiki-API

• Erste Schritte (en)
• FAQ (en)
• Datenformate (en)
• Fehlermeldungen (en)
• API-Benutzung einschränken (en)
• Authentifizierung
  • Login (en)
  • Logout (en)
• Abfragen (en)
  • Meta-Informationen (en)
  • Eigenschaften (en)
  • Listen (en)
• Vorlagen expandieren und wiedergeben (en)
• Den Seiten-Cache leeren (en)
• Parameter-Informationen (en)
• Bearbeiten (en)
  • Seiten anlegen/ändern (en)
  • Seiten verschieben (en)
  • Rollback (en)
  • Seiten löschen (en)
  • Gelöschte Änderungen wiederherstellen (en)
  • Seiten (ent-)sperren (en)
  • Benutzer (ent-)sperren (en)
  • Seiten (nicht mehr) beobachten (en)
  • E-Mails verschicken (en)
  • Änderungen kontrollieren (en)
  • Artikel importieren (en)
  • Benutzerrechte ändern (en)
  • Bilder hochladen (en)
• MediaWiki-Erweiterungen, welche die API erweitern (en)
• Interne API-Nutzung und Erweiterungen (en)
• Vermischtes (en)
• Implementation (en)
• Bekannte API-Nutzer (en)

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.

Beschränkungen/Limits

Alle Listen-Abfragen geben eine beschränkte Anzahl von Ergebnissen zurück. Diese Beschränkung liegt standardmäßig bei 10, sie kann für normale Nutzer auf 500 und für Benutzer mit apihighlimits-Rechten (normalerweise Bots und Administratoren) auf 5000 gesetzt werden. Einige Module erlegen unter bestimmten Bedingungen strengere Beschränkungen auf. Wenn du dir nicht sicher bist, welches Maximum auf dich zutrifft und du so viele Ergebnisse wie möglich erhalten willst, setze das Limit auf max. In diesem Fall wird limits-Element zurückgegeben, das das benutzte Limit anzeigt.

Fehler

Wenn du das Limit auf einen höheren Wert als das Maximum setzt, wird eine Fehlermeldung zurückgegeben, die wie folgt aussieht:

• code: aplimit
  • info: aplimit may not be over 500 (set to 1000) for users
    • aplimit darf für Benutzer nicht größer als 500 sein (1000 war angegeben)

(ap kann durch jedes andere Modulpräfix ersetzt werden)

Beispiel

Gibt die größte Anzahl von Versionen mit Inhalt und Links auf en:Winnipeg, Manitoba zurück

api.php ? action=query & titles=Winnipeg,_Manitoba & prop=revisions & rvlimit=max & rvprop=content & list=backlinks & bltitle=Winnipeg,_Manitoba & bllimit=max

<?xml version="1.0" encoding="utf-8"?>
<api>
  <query>
    <pages>
      <page pageid="6842860" ns="0" title="Winnipeg, Manitoba">
        <revisions>
          <rev>#REDIRECT [[Winnipeg]]
{{R from Canadian settlement name}}</rev>
          <rev>#REDIRECT [[Winnipeg]]</rev>
        </revisions>
      </page>
    </pages>
    <backlinks>
      <bl pageid="924" ns="0" title="A. A. Milne" />
      <bl pageid="5959" ns="0" title="Canadian Pacific Railway" />
      <!-- ... -->
      <bl pageid="708754" ns="2" title="User:ChrisErbach" />
      <bl pageid="802133" ns="2" title="User:Earl Andrew/54nl) 80X" />
    </backlinks>
  </query>
  <limits revisions="50" backlinks="500" />
  <query-continue>
    <backlinks blcontinue="0|Winnipeg,_Manitoba|994168" />
  </query-continue>
</api>

allpages / ap (Alle Seiten)

MediaWiki version:

1.9

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

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 Interwikilinks
  • all: Liste alle Seiten, egal ob sie Interwikilinks haben (Standard)
  • withlanglinks: Liste nur Seiten mit Interwikilinks
  • withoutlanglinks: Liste nur Seiten ohne Interwikilinks
• 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: Verschiebegeschü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

Beispiel

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

api.php ? action=query & list=allpages & apfrom=Kre & aplimit=5

<?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>

Nutzung als Generator

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

api.php ? action=query & generator=allpages & gapfrom=Kre & gaplimit=5 & prop=info

<?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>

Mögliche Fehler

• code: apparams
  • info: Use "gapfilterredir=nonredirects" option instead of "redirects" when using allpages as a generator
    • 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
    • prlevel darf nicht ohne prtype verwendet werden

alllinks / al (Alle Links auf bestimmte Ziele)

MediaWiki version:

1.11

Gibt eine Liste von (optional: eindeutigen) Links auf Seiten in einem bestimmten Namensraum, geordnet nach Linktitel

Parameter

• alcontinue: Wird benutzt, um eine vorige Anfrage fortzusetzen
• alfrom: Starte die Aufzählung bei diesem Titel. Der Titel muss nicht existieren
• alprefix: Gibt nur Links auf Titel zurück, die mit diesem Wert anfangen
• alnamespace: Der Namensraum, auf den verlinkt wird. Es kann nur ein Namensraum gleichzeitig angegeben werden. Standardmäßig wird der Hauptnamensraum benutzt
• alunique: Wenn gesetzt, werden mehrfache Links auf denselben Titel nur einmal zurückgegeben. Kann nicht benutzt werden, wenn dieses Modul als Generator eingesetzt oder alprop=ids benutzt wird
• allimit: Maximale Anzahl der zurückgegebenen Links (Standard ist 10)
• alprop: Welche Eigenschaften sollen zurückgegeben werden?
  • ids: Seiten-IDs der Seiten, von denen verlinkt wird. Kann nicht zusammen mit alunique verwendet werden
  • title: Verlinkte Titel (Standard)

Beispiel

Gibt alle Links auf Diskussionsseiten zurück, deren Namen mit Talk:API starten

api.php ? action=query & list=alllinks & alprefix=API & alnamespace=1 & alprop=ids|title

<?xml version="1.0" encoding="utf-8"?>
<api>
  <query-continue>
    <alllinks alcontinue="APILAS|5484123" />
  </query-continue>
  <query>
    <alllinks>
      <l fromid="3633229" ns="1" title="Talk:API" />
      <l fromid="14912955" ns="1" title="Talk:API-Calculus" />
      <l fromid="15131143" ns="1" title="Talk:API5" />
      <l fromid="15165243" ns="1" title="Talk:API5" />
      <l fromid="8327984" ns="1" title="Talk:APIIC Tower" />
      <l fromid="14109257" ns="1" title="Talk:APIIC Tower" />
      <l fromid="14177354" ns="1" title="Talk:APIIC Tower" />
      <l fromid="14180196" ns="1" title="Talk:APIIC Tower" />
      <l fromid="6760965" ns="1" title="Talk:APIIT" />
      <l fromid="12229053" ns="1" title="Talk:APILAS" />
    </alllinks>
  </query>
</api>

Mögliche Fehler

• code: alparams
  • info: alllinks cannot be used as a generator in unique links mode
    • alllinks kann nicht als Generator benutzt werden, wenn eindeutige Linkziele verlangt werden
• code: alparams
  • info: alllinks cannot return corresponding page ids in unique links mode
    • alllinks kann die zugehörigen Seiten-IDs nicht zurückgeben, wenn eindeutige Linkziele verlangt werden
      • Dies passiert, wenn alunique und alprop=ids zusammen verwendet werden
• code: alparams
  • info: alcontinue and alfrom cannot be used together
    • alcontinue und alfrom können nicht zusammen verwendet werden