API:Query - Properties/de

From MediaWiki.org

Diese seite ist noch nicht vollständig übersetzt

Das Eigenschaften-Submodul (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 1 info / in 1.1 Beispiel 1.2 Mögliche Warnungen 2 revisions / rv 2.1 Parameter 2.2 Beispiele 2.3 Mögliche Warnungen 2.4 Mögliche Fehler

[edit] info / in

Liefert Grundlegende Informationen über einen Artikel.

Normalerweise werden folgende Informationen geliefert:

• die ID des Artikels
• die Namespace-ID des Artikels
• der Titel der Site.
• wann die Seite das letzte mal bearbeitet wurde
• die ID der letzten Revision
• die Anzahl der bearbeitungen
• die größe der Seite in Bytes
• redirect="", falls es sich um ein redirect 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 pipe getrennt

• protection: Den 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. Tokens sind notwendig um diese Aktionen durchzuführen. Mögliche aktionen sind:

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

[edit] Beispiel

[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.

[edit] revisions / rv

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 (default)
  • flags: Information darüber, ob die Revision ein Botedit oder als "kleine Änderung" markiert ist. (default)
  • timestamp: Datum und Zeit der Revision (default)
  • user: Der Autor dieser Revision (default)
  • comment: die angegebene Zusammenfassung (default)
  • size: Die größe des Artikels in Byte
  • content: Den Inhalt der Revision. Wenn dies verwendet wird, sinkt das Limit auf 10. Der Inhalt wird als Wikitext geliefert. Wenn du eine HTML-Seite möchtest, solltest du dir action=parse ansehen.
• rvuser: Liste nur die Revisionen, welche von diesem Benutzer erstellt wurden.
• rvexcludeuser: Liste nicht die Revisionen dieses Users.
• rvexpandtemplates: Ersetze verwendete Templates mit deren Inhalt.
• rvsection: Wenn rvprop=content gesetzt wurde, liefere nur den entsprechenden Absatz.
• rvtoken: Ermittelt entsprechende Tokens
  • rollback: Rollback token

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 (default). NOTE: rvstart(id) muss größer sein als rvend(id)
  • newer: Älteste Revision zuerst NOTE: rvstart(id) muss kleiner sein als rvend(id)

[edit] Beispiele

[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 rrevid
    • der angegebene Absatz existiert nicht