API:Properties/de
| Diese Seite ist Teil der deutschen Übersetzung der MediaWiki-API-Dokumentation. |
| Sprache: | English • Deutsch • Español • 日本語 • Українська |
|---|
- Erste Schritte (en)
- FAQ (en)
- Datenformate (en)
- Fehlermeldungen (en)
- API-Benutzung einschränken (en)
- Authentifizierung
- 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)
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
[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 handeltmissing="", 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
[edit] Beispiel
Erhalte Informationen für den Artikel über de:Albert Einstein
<?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.
- Bedeutet, dass mit
- 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 Bytecontent: 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 ansehentags: Versionsmarkierungen, wie solche, die durch die Erweiterung AbuseFilter hinzugefügt werden. Nur in neueren Versionen implementiert
rvcontinue: Wird genutzt, wenn weitere Ergebnisse verfügbar sindrvuser: Liste nur die Versionen, welche von diesem Benutzer erstellt wurdenrvexcludeuser: Versionen dieses Benutzers nicht anzeigenrvexpandtemplates: Ersetze verwendete Vorlagen mit deren Inhaltrvsection: Wennrvprop=contentgesetzt wurde, liefere nur den entsprechenden Absatzrvtoken: Ermittelt entsprechende Tokenrollback: Rollback-Token
rvdiffto: Revision-ID, mit der verglichen werden soll oder next, prev oder currvdifftotext: 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 werdenrvstartid: Revisions-ID, bei der die Liste beginntrvendid: Revisions-ID, bei der die Liste endetrvstart: Timestamp, bei der die Liste beginntrvend: Timestamp, bei der die Liste endetrvdir: Die verwendete Sortierungolder: 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> <?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> <?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.
- info: The revids= parameter may not be used with the list options (limit, startid, endid, dirNewer, start, end).
- 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.
- 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.
- code: rvaccessdenied
- info: The current user is not allowed to read title
- Der Zugriff wurde verweigert.
- info: The current user is not allowed to read title
- code: rvbadparams
- info: start and startid cannot be used together
- start und startid dürfen nicht zusammen verwendet werden
- info: start and startid cannot be used together
- code: rvbadparams
- info: end and endid cannot be used together
- end und endid dürfen nicht zusammen verwenden werden
- info: end and endid cannot be used together
- code: rvbadparams
- info: user and excludeuser cannot be used together
- user und excludeuser dürfen nicht zusammen verwendet werden.
- info: user and excludeuser cannot be used together
- code: rvnosuchsection
- info: There is no section section in revid
- der angegebene Absatz existiert nicht
- info: There is no section section in revid
[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üsseltimestamp: 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.hiddenund!hidden) können nicht gemeinsam verwendet werdenhidden: Nur versteckte Kategorien zurückgeben!hidden: Versteckte Kategorien nicht zurückgeben
cllimit: Obergrenze für die Anzahl der zurückgegebenen Ergebnisseclcontinue: Wenn weiter Ergebnisse verfügbar sind, zum Fortfahren benutzenclcategories: 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> <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
- info: Incorrect parameter - mutually exclusive values may not be supplied
[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
<?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> <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 sollentimestamp: Zeitstempel der Version (Standard)user: Benutzer, der die Version erstellt hatcomment: Der Bearbeitungskommentarurl: Der URL der Dateisize: Die Größe der Datei in Bytes, zzgl. Höhe und Breitesha1: Der SHA-1-Hashmime: Der MIME-Typ der Dateimetadata: Metadaten, falls verfügbararchivename: Archivname (nur alte Dateien)
iilimit: Gibt an, wie viele Dateiversionen zurückgegeben werden sollen (standardmäßig eine)iistart: Zeitstempel, ab dem aufgelistet werden solliiend: Zeitstempel, bis zu dem aufgelistet werden solliiurlwidth: Wenniiprop=urlgesetzt ist, wird auch eine URL zu einer Datei zurückgegeben, die auf diese Breite skaliert ist. Alte Dateiversionen können nicht skaliert werdeniiurlheight: Analog zuiiurlwidth, 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.
<?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 Ergebnissedfcontinue: Wird genutzt, wenn weitere Ergebnisse vorliegen
[edit] Beispiel
Gibt Duplikate von zwei Dateien zurück
<?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
<?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 anzeigenpllimit: 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> <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 10eloffset: Wird genutzt, wenn weitere Ergebnisse vorliegen
[edit] Beispiel
Gibt eine Liste der externen Links auf en:Albert Einstein zurück
<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ückgebentllimit: maximale Anzahl der zurückgegebenen Vorlagen
[edit] Beispiel
Gibt eine Liste der Vorlagen zurück, die auf en:Albert Einstein eingebunden werden
<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