API:Rollback/de
Appearance
Diese Seite ist Teil der Dokumentation der MediaWiki action API. |
MediaWiki Version: | ≥ 1.12 |
POST-Abfrage um die letzte Reihe von Bearbeitungen eines Benutzers an einer bestimmten Seite zurückzusetzen.
Diese Funktionalität entspricht der Funktionalität des Zurücksetzen-Links in der Versionshistorien-Seite der grafischen Benutzeroberfläche.
API-Dokumentation
Beispiel
Eine POST-Abfrage zu stellen ist ein mehrstufiger Prozess:
- Anmelden über eine der auf API:Login beschriebenen Methoden.
- Ein CSRF-Token erhalten:
- Sende eine POST-Abfrage mit dem CSRF-Token, um eine Aktion auf einer Seite auszuführen und dabei
editpage
-Rechte für diese Seite zu erhalten: - GET a rollback token:
- Wenn dein Wiki MediaWiki 1.24+ nutzt, folge diesen Anweisungen:
- Rollback-Tokens sind nicht universell: Sie ändern sich nicht nur mit jedem Login, sondern sind auch abhängig vom Titel der Seite und dem Namen des Users, dessen Änderungen zurückgesetzt werden sollen. Für MediaWiki 1.23 oder früher, folge den Folgenden Anweisungen:
POST-Anfrage
Sende eine POST-Abfrage mit einem Zurücksetzungs-Token, um die Bearbeitungen eines Benutzers auf der Spielwiese zurückzusetzen.
In diesem Beispiel werden alle Parameter mit einer GET-Anfrage übermittelt, um es einfach zu halten. Allerdings erfordert action=rollback POST-Anfragen, und GET-Anfragen verursachen einen Fehler.
api.php? action=rollback& format=json& title=Sandbox& user=41.190.3.231& token=d36a517a732991d5aaafae8bd40eee4a5c7bf75a+\\ [In der ApiSandbox ausprobieren]
Antwort
Der Antwort-Abschnitt unten ist für die finale POST-Abfrage, um die Bearbeitungen auf der Spielwiese zurückzusetzen.
{
"rollback": {
"title": "Sandbox",
"pageid": 94542,
"summary": "Reverted edits by [[Special:Contributions/41.190.3.231|41.190.3.231]] ([[User talk:41.190.3.231|talk]]) to last revision by [[User:Didicodes|Didicodes]]",
"revid": 381084,
"old_revid": 381083,
"last_revid": 381070
}
}
Die Versions-IDs in der Antwort sind:
revid
- Die ID der neuen Version, die durch die Zurücksetzung erstellt wurde.old_revid
- Die ID der neuesten Version, die zurückgesetzt wird. Vor der Zurücksetzung war dies die aktuelle Version.last_revid
- Die ID der Version, die durch die Zurücksetzung wiederhergestellt wird. Dies ist die neueste Version, die zurückgesetzt wurde.
Beispielcode
Python
#!/usr/bin/python3
"""
rollback.py
MediaWiki API Demos
Demo of `rollback` module: Sending post request to rollback the
last edits made to a given page.
MIT license
"""
import requests
S = requests.Session()
URL = "https://test.wikipedia.org/w/api.php"
# Step 1: Retrieve a login token
PARAMS_1 = {
"action": "query",
"meta": "tokens",
"type": "login",
"format": "json"
}
R = S.get(url=URL, params=PARAMS_1)
DATA = R.json()
LOGIN_TOKEN = DATA['query']['tokens']['logintoken']
# Step 2: Send a post request to login. Use of main account for login is not
# supported. Obtain credentials via Special:BotPasswords
# (https://www.mediawiki.org/wiki/Special:BotPasswords) for lgname & lgpassword
PARAMS_2 = {
"action": "login",
"lgname": "bot_user_name",
"lgpassword": "bot_password",
"lgtoken": LOGIN_TOKEN,
"format": "json"
}
R = S.post(URL, data=PARAMS_2)
# Step 3: While logged in, retrieve a CSRF token
PARAMS_3 = {
"action": "query",
"meta": "tokens",
"format": "json"
}
R = S.get(url=URL, params=PARAMS_3)
DATA = R.json()
CSRF_TOKEN = DATA["query"]["tokens"]["csrftoken"]
# Step 4: POST request to edit a page
PARAMS_4 = {
"action": "edit",
"title": "Project:Sandbox",
"token": CSRF_TOKEN,
"format": "json",
"appendtext": "Hello"
}
R = S.post(URL, data=PARAMS_4)
# Step 5: Retrieve a rollback token
PARAMS_5 = {
"action": "query",
"meta": "tokens",
"type": "rollback",
"format": "json"
}
R = S.get(url=URL, params=PARAMS_5)
DATA = R.json()
ROLLBACK_TOKEN = DATA['query']['tokens']['rollbacktoken']
# Step 5: POST request to rollback a page
PARAMS_6 = {
"action": "rollback",
"format": "json",
"title": "Project:Sandbox",
"user": "bot_user_name",
"token": ROLLBACK_TOKEN,
}
R = S.post(URL, data=PARAMS_6)
DATA = R.json()
print(DATA)
PHP
<?php
/*
rollback.php
MediaWiki API Demos
Demo of `rollback` module: Sending post request to rollback the
edits of a given page.
MIT license
*/
$endPoint = "http://dev.wiki.local.wmftest.net:8080/w/api.php";
$login_Token = getLoginToken(); // Step 1
loginRequest( $login_Token ); // Step 2
$rollback_Token = getRollbackToken(); // Step 3
rollback( $rollback_Token ); // Step 4
// Step 1: GET request to fetch login token
function getLoginToken() {
global $endPoint;
$params1 = [
"action" => "query",
"meta" => "tokens",
"type" => "login",
"format" => "json"
];
$url = $endPoint . "?" . http_build_query( $params1 );
$ch = curl_init( $url );
curl_setopt( $ch, CURLOPT_RETURNTRANSFER, true );
curl_setopt( $ch, CURLOPT_COOKIEJAR, "cookie.txt" );
curl_setopt( $ch, CURLOPT_COOKIEFILE, "cookie.txt" );
$output = curl_exec( $ch );
curl_close( $ch );
$result = json_decode( $output, true );
return $result["query"]["tokens"]["logintoken"];
}
// Step 2: POST request to log in. Use of main account for login is not
// supported. Obtain credentials via Special:BotPasswords
// (https://www.mediawiki.org/wiki/Special:BotPasswords) for lgname & lgpassword
function loginRequest( $logintoken ) {
global $endPoint;
$params2 = [
"action" => "login",
"lgname" => "bot_user_name",
"lgpassword" => "bot_password",
"lgtoken" => $logintoken,
"format" => "json"
];
$ch = curl_init();
curl_setopt( $ch, CURLOPT_URL, $endPoint );
curl_setopt( $ch, CURLOPT_POST, true );
curl_setopt( $ch, CURLOPT_POSTFIELDS, http_build_query( $params2 ) );
curl_setopt( $ch, CURLOPT_RETURNTRANSFER, true );
curl_setopt( $ch, CURLOPT_COOKIEJAR, "cookie.txt" );
curl_setopt( $ch, CURLOPT_COOKIEFILE, "cookie.txt" );
$output = curl_exec( $ch );
curl_close( $ch );
}
// Step 3: GET request to fetch rollback token
function getRollbackToken() {
global $endPoint;
$params3 = [
"action" => "query",
"meta" => "tokens",
"type" => "rollback",
"format" => "json"
];
$url = $endPoint . "?" . http_build_query( $params3 );
$ch = curl_init( $url );
curl_setopt( $ch, CURLOPT_RETURNTRANSFER, true );
curl_setopt( $ch, CURLOPT_COOKIEJAR, "cookie.txt" );
curl_setopt( $ch, CURLOPT_COOKIEFILE, "cookie.txt" );
$output = curl_exec( $ch );
curl_close( $ch );
$result = json_decode( $output, true );
return $result["query"]["tokens"]["rollbacktoken"];
}
// Step 4: POST request to rollback a page
function rollback( $rollback_Token ) {
global $endPoint;
$params4 = [
"action" => "rollback",
"title" => "Project:Sandbox",
"user" => "10.0.2.2",
"token" => $rollback_Token,
"format" => "json"
];
$ch = curl_init();
curl_setopt( $ch, CURLOPT_URL, $endPoint );
curl_setopt( $ch, CURLOPT_POST, true );
curl_setopt( $ch, CURLOPT_POSTFIELDS, http_build_query( $params4 ) );
curl_setopt( $ch, CURLOPT_RETURNTRANSFER, true );
curl_setopt( $ch, CURLOPT_COOKIEJAR, "cookie.txt" );
curl_setopt( $ch, CURLOPT_COOKIEFILE, "cookie.txt" );
$output = curl_exec( $ch );
curl_close( $ch );
echo ( $output );
}
JavaScript
/*
rollback.js
MediaWiki API Demos
Demo of `rollback` module: Sending post request to rollback the
edits of a given page.
MIT license
*/
var request = require('request').defaults({jar: true}),
url = "http://dev.wiki.local.wmftest.net:8080/w/api.php";
// Step 1: GET request to fetch login token
function getLoginToken() {
var params_0 = {
action: "query",
meta: "tokens",
type: "login",
format: "json"
};
request.get({ url: url, qs: params_0 }, function (error, res, body) {
if (error) {
return;
}
var data = JSON.parse(body);
loginRequest(data.query.tokens.logintoken);
});
}
// Step 2: POST request to log in.
// Use of main account for login is not
// supported. Obtain credentials via Special:BotPasswords
// (https://www.mediawiki.org/wiki/Special:BotPasswords) for lgname & lgpassword
function loginRequest(login_token) {
var params_1 = {
action: "login",
lgname: "bot_username",
lgpassword: "bot_password",
lgtoken: login_token,
format: "json"
};
request.post({ url: url, form: params_1 }, function (error, res, body) {
if (error) {
return;
}
getRollbackToken();
});
}
// Step 3: GET request to fetch Rollback token
function getRollbackToken() {
var params_2 = {
action: "query",
meta: "tokens",
type: "rollback",
format: "json"
};
request.get({ url: url, qs: params_2 }, function(error, res, body) {
if (error) {
return;
}
var data = JSON.parse(body);
rollback(data.query.tokens.rollbacktoken);
});
}
// Step 4: POST request to rollback a page
function rollback(rollback_token) {
var params_3 = {
action: "rollback",
title: "Project:Sandbox",
user: "10.0.2.2",
token: rollback_token,
format: "json"
};
request.post({ url: url, form: params_3 }, function (error, res, body) {
if (error) {
return;
}
console.log(body);
});
}
// Start From Step 1
getLoginToken();
MediaWiki JS
/*
rollback.js
MediaWiki API Demos
Demo of `rollback` module: Sending post request to rollback the
last edits made to a given page.
MIT License
*/
var params = {
action: 'rollback',
title: 'Sandbox',
user: '10.0.2.2',
format: 'json'
},
api = new mw.Api();
api.postWithToken( 'rollback', params ).done( function ( data ) {
console.log( data );
} );
Berechtigungen
Zurücksetzen erfordert die Rechte edit
und rollback
auf der Zielseite; das bedeutet derzeit, dass OAuth-Nutzern, Botpasswörtern, etc. editpage
und rollback
gewährt werden müssen – rollback
allein reicht nicht!
Mögliche Fehler
Zusätzlich zum Üblichen Kram
Code | Info |
---|---|
alreadyrolled | Die Seite wurde bereits zurückgesetzt |
missingparams | Einer der Parameter title und pageid ist erforderlich.
|
mustpostparams | Das Zurücksetzungs-Modul erfordert eine POST-Abfrage. |
notitle | The title parameter must be set. |
notoken | The token parameter must be set. |
nouser | The user parameter must be set. |
onlyauthor | Die Seite hat nur einen Autor |
permissiondenied | Die von dir angeforderte Aktion ist auf Benutzer in einer der folgenden Gruppen beschränkt: Administratoren, Zurücksetzer |
Parametergeschichte
- v1.24: Eingeführt
pageid
- v1.27: Eingeführt
tags
- v1.17: Eingeführt
watchlist
Zusätzliche Anmerkungen
- Optional können sowohl der Zurücksetzer als auch die Änderungen, die zurückgesetzt werden, als Bot markiert werden, was sie standardmäßig vor Special:RecentChanges verbirgt.
Siehe auch
- API:Bearbeiten - Bearbeitet eine Seite.
- Hilfe:Bearbeiten - Enthält nützliche Links zum Bearbeiten von Artikeln.
- API:Tokens - Hat weitere Details zur Nutzung von Tokens zum Anmelden oder Stellen von POST-Abfragen.
- API:Tokens (Action) - Eine missbilligte API, verschieden von API:Tokens , zur Abfrage von Tokens in früheren Versionen von MediaWiki.
- API:Dateizurücksetzung - Setzt Dateien auf einen früheren Status zurück.
- API:Versionslöschung - Löscht und stellt Revisionen einer Seite wieder her.
- API:Vergleichen - Erlaubt dir, zwischen Bearbeitungen auf einer Seite zu unterscheiden.