API:Query - Properties/de

From MediaWiki.org

Jump to: navigation, search
Diese Seite ist Teil der deutschen Übersetzung der MediaWiki-API-Dokumentation.
MediaWiki-API


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

[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

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.

[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


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

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