API:Rollback/de

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

Sprache:	English  • Deutsch

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)

MediaWiki version:

1.12

Zurücksetzen/Rollback

Zurücksetzen (engl.: rollback) bedeutet, die zusammenhängenden letzten Änderungen eines Benutzer rückgängig zu machen. Anders ausgedrückt setzt Rollback nacheinander jede Version eines bestimmten Benutzers zurück, bis es auf eine Version eines anderen Benutzers stößt. Dies ist identisch mit den „Zurücksetzen“-Links der grafischen Oberfläche. Die dadurch erzeugte Version wird als kleine Bearbeitung gekennzeichnet. Optional kann das Zurücksetzen mitsamt den zurückgesetzten Versionen als Bot-Bearbeitung gekennzeichnet werden, wodurch sie standardmäßig auf Spezial:Letzte Änderungen nicht angezeigt werden.

Token

Um eine Seite zurückzusetzen wird ein Rollback-Token benötigt. Rollback-Token sind im Gegensatz zu den meisten anderen Token nicht universell einsetzbar: Sie sind nicht nur bei jedem Login verschieden, sondern hängen auch vom Seitennamen und vom Bearbeiter ab, der zurückgesetzt werden soll. Ein Rollback-Token kann man folgendermaßen erhalten:

Ein Rollback-Token erhalten

api.php ? action=query & prop=revisions & rvtoken=rollback & titles=Main%20Page

<?xml version="1.0" encoding="utf-8"?>
<api>
  <query>
    <pages>
      <page pageid="5" ns="0" title="Main Page" rollbacktoken="094a45ddbbd5e90d55d79d2a23a8c921+\">
        <revisions>
          <rev revid="20" user="Catrope" timestamp="2007-09-03T20:32:20Z" />
        </revisions>
      </page>
    </pages>
  </query>
</api>

Seiten zurücksetzen

Seiten werden mit action=rollback zurückgesetzt.

Parameter

• title: Die Seite, die du zurücksetzen möchtest.
• token: Der in der vorherigen Abfrage erhaltene Token. Das ‘+’ muss als ‘%2B’ urlencoded sein.
• user: Der Bearbeiter der letzten Version.
• summary: Optionale Zusammenfassung, wenn nicht gesetzt, wird die Standardzusammenfassung verwendet.
• markbot: Wenn gesetzt, werden Zurücksetzen und die zurückgesetzten Versionen als Bot-Bearbeitungen gekennzeichnet.

Beispiel

Beachte: In diesem Beispiel werden alle Parameter der Einfachheit wegen als GET-Anforderung gesendet. Jedoch muss action=rollback mit einer POST-Anforderung gesendet werden, GET-Anforderungen liefern einen Fehler zurück.

Setze die Bearbeitungen von Benutzername an der Hauptseite mit einer Standardbegründung zurück und kennzeichne alle als Bot-Bearbeitungen

api.php ? action=rollback & title=Hauptseite & user=Benutzername & markbot & token=094a45ddbbd5e90d55d79d2a23a8c921%2B\

<?xml version="1.0" encoding="utf-8"?>
<api>
  <rollback
    title="Main Page"
    pageid="5"
    summary="Änderungen von [[Special:Contributions/Benutzername|Benutzername]] rückgängig gemacht und letzte Version von [[User:VorherigerBearbeiter|VorherigerBearbeiter]] wiederhergestellt"
    revid="28"
    old_revid="27"
    last_revid="20" />
</api>

Rückgabefelder

• revid: Revision ID des Zurücksetzens
• old_revid: Revision ID der jüngsten zurückgesetzten Version
• last_revid: Revision ID der ältesten zurückgesetzten Version

Falls das Zurücksetzen den Seiteninhalt nicht verändern würde, wird keine neue Version erstellt. In diesem Fall ist revid gleich old_revid.

Fehler

Zusätzlich zu den üblichen Fehlern:

• code: notitle
  • info: The title parameter must be set
    • Der Parameter title muss angegeben werden
• code: nouser
  • info: The user parameter must be set
    • Der Parameter user muss angegeben werden
• code: notoken
  • info: The token parameter must be set
    • Der Parameter token muss angegeben werden
• code: alreadyrolled
  • info: The page you tried to rollback was already rolled back
    • Die Seite wurde bereits zurückgesetzt
• code: onlyauthor
  • info: The page you tried to rollback only has one author
    • Die Seite hat nur einen Bearbeiter