API:Rollback/de

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:

Seiten zurücksetzen
Seiten werden mit action=rollback zurückgesetzt.

Parameter

 * : Die Seite, die du zurücksetzen möchtest.
 * : Der in der vorherigen Abfrage erhaltene Token. Das ‘+’ muss als ‘%2B’ urlencoded sein.
 * : Der Bearbeiter der letzten Version.
 * : Optionale Zusammenfassung, wenn nicht gesetzt, wird die Standardzusammenfassung verwendet.
 * : 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.

Rückgabefelder
Falls das Zurücksetzen den Seiteninhalt nicht verändern würde, wird keine neue Version erstellt. In diesem Fall ist  gleich.
 * : Revision ID des Zurücksetzens
 * : Revision ID der jüngsten zurückgesetzten Version
 * : Revision ID der ältesten zurückgesetzten Version

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