API:Properties/de

From MediaWiki.org
Jump to: navigation, search
Tools clipart.png Diese Seite ist Teil der deutschen Übersetzung der MediaWiki-API-Dokumentation.
Sprache: English  • Deutsch • Español • 日本語 • Українська
MediaWiki-API


Das Properties-Untermodul (properties bzw. prop) wird dafür verwendet, nähere Informationen von einem oder mehreren Artikeln zu erhalten. Die Artikel können dabei wie gewohnt entweder direkt mittels titles=, pageids= oder revids= oder dynamisch mit einem Generator übergeben werden

Contents

[edit] info / in (Seiteninformationen)

MediaWiki version: 1.9

Liefert grundlegende Informationen über einen Artikel.

Normalerweise werden folgende Informationen geliefert:

  • die ID des Artikels
  • die Namensraum-ID des Artikels
  • der Titel der Seite
  • wann die Seite das letzte Mal bearbeitet wurde
  • die ID der letzten Revision
  • die Anzahl der Bearbeitungen
  • die Größe der Seite in Byte
  • redirect="", falls es sich um eine Weiterleitung handelt
  • missing="", falls der Artikel nicht existiert

Optional können noch folgende informationen ermittelt werden, dazu muss die entsprechende option mittels inprop= übergeben werden. Mehrere optionen werden mit einem senkrechten Strich (|) getrennt

  • protection: Der Schutzlevel jeder Seite
  • talkid: Die ID der Diskussionsseite für jede Nicht-Diskussionsseite
  • subjectid: Die ID der Nicht-Diskussionsseite für jede Diskussionsseite

Mit dem Parameter intoken= kann man noch eine Liste an Aktionen übergeben, für die man den entsprechenden Token haben möchte. Token sind notwendig um diese Aktionen durchzuführen. Mögliche Aktionen sind:

  • edit
  • delete
  • protect
  • move
  • block
  • unblock
  • email

[edit] Beispiel

Erhalte Informationen für den Artikel über de:Albert Einstein

api.php ? action=query & titles=Albert%20Einstein & prop=info & inprop=protection|talkid
<?xml version="1.0"?>
<api>
  <query>
    <pages>
      <page pageid="1278360" ns="0" title="Albert Einstein" touched="2008-09-15T10:49:16Z" lastrevid="50698885" counter="0" length="74441" talkid="40315">
        <protection>
          <pr type="edit" level="autoconfirmed" expiry="infinity" />
          <pr type="move" level="autoconfirmed" expiry="infinity" />
        </protection>
      </page>
    </pages>
  </query>
</api>

[edit] Mögliche Warnungen

  • Action „action“ is not allowed for the current user
    • Bedeutet, dass mit intoken= der Token einer Aktion angefordert wurde, welche dem Benutzer nicht erlaubt ist.
  • No support for special pages has been implemented
    • Wird zurückgegeben, wenn eine Spezialseite angefordert wird.

[edit] revisions / rv (Versionen)

MediaWiki version: 1.8

Liefert die Revisionen einer Seite oder die letzte Revision (und den Inhalt) von mehreren übergebenen Seiten.

[edit] Parameter

  • rvprop: Welche Informationen abgefragt werden sollen:
    • ids: Revision-ID (Standard)
    • flags: Information darüber, ob die Revision ein Botedit oder als "kleine Änderung" markiert ist. (Standard)
    • timestamp: Datum und Zeit der Revision (Standard)
    • user: Der Autor dieser Revision (Standard)
    • comment: die angegebene Zusammenfassung (Standard)
    • size: Die Größe des Artikels in Byte
    • content: Den Inhalt der Revision. Wenn dies verwendet wird, sinkt das Limit auf 1/10. Der Inhalt wird als Wikitext geliefert. Wenn du eine HTML-Seite möchtest, solltest du dir action=parse ansehen
    • tags: Versionsmarkierungen, wie solche, die durch die Erweiterung AbuseFilter hinzugefügt werden. Nur in neueren Versionen implementiert
  • rvcontinue: Wird genutzt, wenn weitere Ergebnisse verfügbar sind
  • rvuser: Liste nur die Versionen, welche von diesem Benutzer erstellt wurden
  • rvexcludeuser: Versionen dieses Benutzers nicht anzeigen
  • rvexpandtemplates: Ersetze verwendete Vorlagen mit deren Inhalt
  • rvsection: Wenn rvprop=content gesetzt wurde, liefere nur den entsprechenden Absatz
  • rvtoken: Ermittelt entsprechende Token
  • rvdiffto: Revision-ID, mit der verglichen werden soll oder next, prev oder cur
  • rvdifftotext: Text, mit dem verglichen werden soll (nur 10 (?) Versionen)

Wenn folgende Parameter verwendet werden, darf maximal ein Titel übergeben werden:

  • rvlimit: Wieviel Revisionen gewünscht werden
  • rvstartid: Revisions-ID, bei der die Liste beginnt
  • rvendid: Revisions-ID, bei der die Liste endet
  • rvstart: Timestamp, bei der die Liste beginnt
  • rvend: Timestamp, bei der die Liste endet
  • rvdir: Die verwendete Sortierung
    • older: Neueste Revision zuerst (Standard). Hinweis: rvstart(id) muss größer sein als rvend(id)
    • newer: Älteste Revision zuerst. Hinweis: rvstart(id) muss kleiner sein als rvend(id)

[edit] Beispiele

Erfrage Daten und Inhalt der Artikel de:Goethe und de:Einstein.

api.php ? action=query & prop=revisions & titles=Goethe|Einstein & rvprop=timestamp|user|comment|content
<api>
  <?xml version="1.0"?>
<api>
  <query>
    <pages>
      <page pageid="3679259" ns="0" title="Einstein">
        <revisions>
          <rev user="Euku" timestamp="2008-08-14T18:24:55Z" comment="Änderungen von [[User:217.93.114.209|217.93.114.209]] ([[Special:Contributions/217.93.114.209|Beiträge]]) rückgängig gemacht und letzte Version von [[User:Ot|Ot]] wiederhergestellt">#REDIRECT [[Albert Einstein]]</rev>
        </revisions>
      </page>
      <page pageid="2136366" ns="0" title="Goethe">
        <revisions>
          <rev user="Rax" timestamp="2008-03-19T15:35:39Z" comment="Revert auf Version von [[Benutzer:Tischbeinahe]] (11. Jan. 2008, 10:40). luschtig">#REDIRECT [[Johann Wolfgang von Goethe]]</rev>
        </revisions>
      </page>
    </pages>
  </query>
</api>

Erfrage die letzten 5 Revisionen von de:Goethe.

api.php ? action=query & prop=revisions & titles=Goethe & rvprop=timestamp|user|comment|content & rvlimit=5
<api>
<?xml version="1.0"?>
<?xml version="1.0"?>
<api>
  <query>
    <pages>
      <page pageid="2136366" ns="0" title="Goethe">
        <revisions>
          <rev user="Rax" timestamp="2008-03-19T15:35:39Z" comment="Revert auf Version von [[Benutzer:Tischbeinahe]] (11. Jan. 2008, 10:40). luschtig">#REDIRECT [[Johann Wolfgang von Goethe]]</rev>
          <rev user="Triebtäter" timestamp="2008-03-19T14:14:18Z" comment="analog zu [[Schiller]]">#REDIRECT [[Goethe (Begriffsklärung)]]</rev>
          <rev user="Tischbeinahe" timestamp="2008-01-11T09:40:19Z" comment="Änderung 40851381 von [[Spezial:Contributions/Atlan da Gonozal|Atlan da Gonozal]] ([[User_talk:Atlan da Gonozal|Diskussion]]) wurde rückgängig gemacht.">#REDIRECT [[Johann Wolfgang von Goethe]]</rev>
          <rev user="Atlan da Gonozal" timestamp="2008-01-06T12:33:56Z" comment="[[Göthe]] linkt  auf die BKL, also sollte dieser Artikel das auch tun">#REDIRECT [[Goethe (Begriffsklärung)]]</rev>
          <rev user="Jed" timestamp="2007-01-06T19:02:20Z" comment="[[Hilfe:Zusammenfassung und Quelle#Auto-Zusammenfassung|AZ]]: Weiterleitung nach [[Johann Wolfgang von Goethe]] erstellt">#REDIRECT [[Johann Wolfgang von Goethe]]</rev>
        </revisions>
      </page>
    </pages>
  </query>
  <query-continue>
    <revisions rvstartid="26057565" />
  </query-continue>
</api>


[edit] Mögliche Warnungen

  • Action „action“> is not allowed for the current user
    • Es wurde ein Token erfragt, den der aktuelle Benutzer nicht verwenden darf.

[edit] Mögliche Fehler

  • code: rvrevids
    • info: The revids= parameter may not be used with the list options (limit, startid, endid, dirNewer, start, end).
      • der revids= parameter darf nicht mit den list-optionen verwendet werden.
  • code: rvmultpages
    • info: titles, pageids or a generator was used to supply multiple pages, but the limit, startid, endid, dirNewer, user, excludeuser, start and end parameters may only be used on a single page.
      • Es wurden Mehrere Seiten angefordert, aber die Parameter limit, startid, endid, dirNewer, user, excludeuser, start und end erlauben nur eine Seite.
  • code: rvaccessdenied
    • info: The current user is not allowed to read title
      • Der Zugriff wurde verweigert.
  • code: rvbadparams
    • info: start and startid cannot be used together
      • start und startid dürfen nicht zusammen verwendet werden
  • code: rvbadparams
    • info: end and endid cannot be used together
      • end und endid dürfen nicht zusammen verwenden werden
  • code: rvbadparams
    • info: user and excludeuser cannot be used together
      • user und excludeuser dürfen nicht zusammen verwendet werden.
  • code: rvnosuchsection
    • info: There is no section section in revid
      • der angegebene Absatz existiert nicht

[edit] categories / cl (Kategorienverwendung)

MediaWiki version: 1.11

Gibt eine Liste aller Kategorien zurück, die auf den angegebenen Seiten verwendet werden. Dieses Modul kann mit einem Generator verwendet werden.

[edit] Parameter

  • clprop: Gibt an, welche Eigenschaften zurückgegeben werden sollen (kann nicht mit einem Generator verwendet werden)
    • sortkey: Sortierschlüssel
    • timestamp: Zeitstempel, an dem die Seite zur Kategorie hinzugefügt, bzw. der Sortierschlüssel geändert wurde
  • clshow: Die Art der zurückgegebenen Kategorien. Konkurrierende Optionen (z. B. hidden und !hidden) können nicht gemeinsam verwendet werden
    • hidden: Nur versteckte Kategorien zurückgeben
    • !hidden: Versteckte Kategorien nicht zurückgeben
  • cllimit: Obergrenze für die Anzahl der zurückgegebenen Ergebnisse
  • clcontinue: Wenn weiter Ergebnisse verfügbar sind, zum Fortfahren benutzen
  • clcategories: Nur diese Kategorien aufführen. Nützlich um zu testen, ob eine bestimmte Seite in einer bestimmten Kategorie ist
    • Dieser Parameter benötigt volle Seitennamen, d. h., dass der Kategorie:-Präfix verwendet werden muss

[edit] Beispiel

Liefere eine Liste der Kategorien, zu denen Albert Einstein gehört

api.php ? action=query & titles=Albert%20Einstein & prop=categories
<api>
  <query>
    <pages>
      <page pageid="736" ns="0" title="Albert Einstein">
        <categories>
          <cl ns="14" title="Kategorie:Albert Einstein" />
          <cl ns="14" title="Kategorie:Deutscher" />
          <cl ns="14" title="Kategorie:Deutscher Auswanderer" />
          …
        </categories>
      </page>
    </pages>
  </query>
</api>

[edit] Mögliche Warnungen

  • „title“ is not a category
    • Die angegebene Seite ist nicht Teil des Kategoriennamensraumes

[edit] Mögliche Fehler

  • code: clshow
    • info: Incorrect parameter - mutually exclusive values may not be supplied
      • Falscher Parameter – es dürfen keine sich gegenseitig ausschließenden Werte angegeben werden

[edit] categoryinfo / ci (Kategorieninformationen)

MediaWiki version: 1.13

Gibt Informationen über Kategorien zurück

Hinweis
Wenn die Kategorienseite existiert, aber die Kategorie keine Seiten enthält, wird kein categoryinfo-Feld zurückgegeben

[edit] Parameter

Keine

[edit] Beispiel

Gibt Informationen über ein paar Kategorien zurück

api.php ? action=query & titles=Albert%20Einstein|Category:Foo|Category:Infobox|Category:Templates_using_ParserFunctions & prop=categoryinfo
<?xml version="1.0" encoding="utf-8"?>
<api>
  <query>
    <normalized>
      <n from="Category:Templates_using_ParserFunctions" to="Category:Templates using ParserFunctions" />
    </normalized>
    <pages>
      <page ns="14" title="Category:Foo" missing="" />
      <page ns="14" title="Category:Templates using ParserFunctions" missing="">
        <categoryinfo size="8" pages="8" files="0" subcats="0" />
      </page>
      <page pageid="736" ns="0" title="Albert Einstein" />
      <page pageid="37" ns="14" title="Category:Infobox">
        <categoryinfo size="0" pages="1" files="-1" subcats="0" />
      </page>
    </pages>
  </query>
</api>

[edit] Mögliche Fehler

Keine

[edit] images / im (Dateiverwendung)

MediaWiki version: 1.9

In der Query-API hat dieser Befehl Seiten zurückgegeben, die eine bestimmte Datei eingebunden haben. Diese Funktion wurde in imageusage umbenannt.

Gibt eine Liste aller Dateien zurück, die auf den angegebenen Seiten verwendet werden. Dieses Modul kann als Generator verwendet werden.

[edit] Parameter

Keine

[edit] Beispiel

Gibt eine Liste der Dateien auf en:Albert Einstein zurück

api.php ? action=query & titles=Albert%20Einstein & prop=images
<api>
  <query>
    <pages>
      <page pageid="736" ns="0" title="Albert Einstein">
        <images>
          <im ns="6" title="Image:1919 eclipse positive.jpg" />
          <im ns="6" title="Image:Albert Einstein Head.jpg" />
          <im ns="6" title="Image:Albert Einstein german.ogg" />
          <im ns="6" title="Image:Albert Einstein photo 1921.jpg" />
          …
        </images>
      </page>
    </pages>
  </query>
</api>

[edit] Mögliche Fehler

Keine

[edit] imageinfo / ii (Dateiinformationen)

MediaWiki version: 1.11

Liefert Dateiinformationen für Seiten im Dateinamensraum

[edit] Parameter

  • iiprop: Gibt an, welche Eigenschaften zurückgegeben werden sollen
    • timestamp: Zeitstempel der Version (Standard)
    • user: Benutzer, der die Version erstellt hat
    • comment: Der Bearbeitungskommentar
    • url: Der URL der Datei
    • size: Die Größe der Datei in Bytes, zzgl. Höhe und Breite
    • sha1: Der SHA-1-Hash
    • mime: Der MIME-Typ der Datei
    • metadata: Metadaten, falls verfügbar
    • archivename: Archivname (nur alte Dateien)
  • iilimit: Gibt an, wie viele Dateiversionen zurückgegeben werden sollen (standardmäßig eine)
  • iistart: Zeitstempel, ab dem aufgelistet werden soll
  • iiend: Zeitstempel, bis zu dem aufgelistet werden soll
  • iiurlwidth: Wenn iiprop=url gesetzt ist, wird auch eine URL zu einer Datei zurückgegeben, die auf diese Breite skaliert ist. Alte Dateiversionen können nicht skaliert werden
  • iiurlheight: Analog zu iiurlwidth, hier wird die Höhe der Datei angegeben

[edit] Beispiel

Gib Dateiinformationen für en:Image:Albert Einstein Head.jpg zurück. Beachte, dass die Dateibeschreibungsseite fehlen kann, wenn die Datei auf Commons existiert.

api.php ? action=query & titles=Image:Albert%20Einstein%20Head.jpg & prop=imageinfo
<?xml version="1.0" encoding="utf-8"?>
<api>
  <query>
    <pages>
      <page ns="6" title="Image:Albert Einstein Head.jpg" missing="" imagerepository="shared">
        <imageinfo>
          <ii timestamp="2007-10-20T02:29:04Z" user="Rocket000" />
        </imageinfo>
      </page>
    </pages>
  </query>
  <query-continue>
    <imageinfo iistart="20071020022358" />
  </query-continue>
</api>

[edit] duplicatefiles / df (Dateiduplikate)

MediaWiki version: 1.14

Gibt Duplikate der angegebenen Dateien zurück

[edit] Parameter

  • dflimit: maximale Anzahl der zurückgegebenen Ergebnisse
  • dfcontinue: Wird genutzt, wenn weitere Ergebnisse vorliegen

[edit] Beispiel

Gibt Duplikate von zwei Dateien zurück

api.php ? action=query & titles=Image:Bombers.ogg|Image:Welcome.gif & prop=duplicatefiles
<?xml version="1.0"?>
<api>
  <query>
    <pages>
      <page pageid="99" ns="6" title="Image:Bombers.ogg">
        <duplicatefiles>
          <df name="Bombers2.ogg" user="Catrope" timestamp="2008-09-27T11:12:45Z" />
        </duplicatefiles>
      </page>
      <page pageid="41" ns="6" title="Image:Welcome.gif">
        <duplicatefiles>
          <df name="Welcome2.gif" user="Catrope" timestamp="2008-09-27T11:30:30Z" />
        </duplicatefiles>
      </page>
    </pages>
  </query>
</api>

[edit] Mögliche Fehler

Keine

[edit] langlinks / ll (Interwikilinks)

MediaWiki version: 1.9

Gibt eine Liste aller Interwikilinks für die angegebene Seite zurück

Gibt nur Interwikilinks für 50 Seiten zurück

[edit] Parameter

  • llcontinue: Wenn weitere Ergebnisse verfügbar sind, benutze dies zum Fortfahren

[edit] Beispiel

Gibt die Liste der Interwikilinks von en:Albert Einstein zurück

api.php ? action=query & titles=Albert%20Einstein & prop=langlinks
<?xml version="1.0" encoding="utf-8"?>
<api>
  <query>
    <pages>
      <page pageid="736" ns="0" title="Albert Einstein">
        <langlinks>
          <ll lang="af">Albert Einstein</ll>
          <ll lang="als">Albert Einstein</ll>
          <ll lang="an">Albert Einstein</ll>
          <ll lang="ar">ألبرت أينشتاين</ll>
          <ll lang="ast">Albert Einstein</ll>
          <ll lang="az">Albert Eynşteyn</ll>
          …
        </langlinks>
      </page>
    </pages>
  </query>
</api>

[edit] Mögliche Fehler

Keine

[edit] links / pl (Links)

MediaWiki version: 1.9

Gibt eine Liste der Seiten zurück, die auf eine bestimmte Seite verlinken. Dieses Modul kann als Generator benutzt werden.

[edit] Parameter

  • plnamespace: Nur Links zu Seiten in diesen Namensräumen anzeigen
  • pllimit : maximale Anzahl der zurückgegebenen Links (nicht mehr als 500 (5000 für Bots und Administratoren))
  • plcontinue: Wird genutzt, wenn weitere Ergebnisse vorliegen

[edit] Beispiel

Gibt eine Liste der Links auf en:Albert Einstein zurück

api.php ? action=query & titles=Albert%20Einstein & prop=links
<api>
  <query>
    <pages>
      <page pageid="736" ns="0" title="Albert Einstein">
        <links>
          <pl ns="0" title="1879" />
          <pl ns="0" title="1901" />
          …
          <pl ns="0" title="Albert Einstein: The Practical Bohemian" />
          <pl ns="0" title="Albert Einstein Archives" />
          <pl ns="0" title="Albert Einstein Award" />
          <pl ns="0" title="Albert Einstein Foundation for Higher Learning, Inc." />
          <pl ns="0" title="Albert Einstein Memorial" />
          <pl ns="0" title="Albert Einstein Peace Prize" />
          …
          <pl ns="0" title="Zurich" />
          <pl ns="4" title="Wikipedia:Citing sources" />
          <pl ns="4" title="Wikipedia:Media help" />
          <pl ns="4" title="Wikipedia:Persondata" />
          <pl ns="4" title="Wikipedia:Protection policy" />
          <pl ns="4" title="Wikipedia:Sister projects" />
          <pl ns="6" title="Image:Albert Einstein german.ogg" />
          <pl ns="10" title="Template:Nobel Prize in Physics" />
          …
          <pl ns="10" title="Template:Nobel Prize in Physics Laureates 2001-2025" />
          <pl ns="11" title="Template talk:Nobel Prize in Physics Laureates 1901-1925" />
        </links>
      </page>
    </pages>
  </query>
</api>

[edit] Mögliche Fehler

Keine

[edit] extlinks / el (Externe Links)

MediaWiki version: 1.11

Gibt eine Liste aller externen Links auf den angegebenen Seite zurück

[edit] Parameter

  • ellimit: Maximale Anzahl der zurückgegebenen Links. Nicht mehr als 500 oder 5000 für Bots und Administatoren. Standardwert ist 10
  • eloffset: Wird genutzt, wenn weitere Ergebnisse vorliegen

[edit] Beispiel

Gibt eine Liste der externen Links auf en:Albert Einstein zurück

api.php ? action=query & titles=Albert%20Einstein & prop=extlinks
<api>
  <query>
    <pages>
      <page pageid="736" ns="0" title="Albert Einstein">
        <extlinks>
          <el>http://albert-einstein.org/</el>
          <el>http://albert-einstein.org/history5.html</el>
          <el>http://ame.epfl.ch/biblio/schlatter1.pdf</el>
          …
        </extlinks>
      </page>
    </pages>
  </query>
</api>

[edit] Mögliche Fehler

Keine

[edit] templates / tl (Vorlagen)

MediaWiki version: 1.9

Gibt eine Liste aller Seiten zurück, die auf den angegebenen Seiten eingebunden werden. Dieses Modul kann als Generator verwendet werden.

[edit] Parameter

  • tlnamespace: Nur Seiten in diesen Namensräumen zurückgeben
  • tllimit: maximale Anzahl der zurückgegebenen Vorlagen

[edit] Beispiel

Gibt eine Liste der Vorlagen zurück, die auf en:Albert Einstein eingebunden werden

api.php ? action=query & titles=Albert%20Einstein & prop=templates
<api>
  <query>
    <pages>
      <page pageid="736" ns="0" title="Albert Einstein">
        <templates>
          <tl ns="10" title="Template:Academia" />
          <tl ns="10" title="Template:Age at date" />
          <tl ns="10" title="Template:Audio" />
          <tl ns="10" title="Template:Birth date" />
          …
        </templates>
      </page>
    </pages>
  </query>
</api>

[edit] Mögliche Fehler

Keine

Retrieved from "http://www.mediawiki.org/w/index.php?title=API:Properties/de&oldid=381136"
Personal tools
Namespaces
Variants
Actions
Site
Support
Download
Development
Communication
Print/export
Toolbox