API:Edit

action=edit

Create and edit pages.

{
"edit":{
"result":"Success",
"pageid":94542,
"title":"Wikipedia:Sandbox",
"contentmodel":"wikitext",
"oldrevid":371705,
"newrevid":371707,
"newtimestamp":"2018年12月18日T16:59:42Z"
}
}

Python

#!/usr/bin/python3
"""
 edit.py
 MediaWiki API Demos
 Demo of `Edit` module: POST request to edit a page
 MIT license
"""
importrequests
S = requests.Session()
URL = "https://test.wikipedia.org/w/api.php"
# Step 1: GET request to fetch login token
PARAMS_0 = {
 "action": "query",
 "meta": "tokens",
 "type": "login",
 "format": "json"
}
R = S.get(url=URL, params=PARAMS_0)
DATA = R.json()
LOGIN_TOKEN = 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
PARAMS_1 = {
 "action": "login",
 "lgname": "bot_user_name",
 "lgpassword": "bot_password",
 "lgtoken": LOGIN_TOKEN,
 "format": "json"
}
R = S.post(URL, data=PARAMS_1)
# Step 3: GET request to fetch CSRF token
PARAMS_2 = {
 "action": "query",
 "meta": "tokens",
 "format": "json"
}
R = S.get(url=URL, params=PARAMS_2)
DATA = R.json()
CSRF_TOKEN = DATA['query']['tokens']['csrftoken']
# Step 4: POST request to edit a page
PARAMS_3 = {
 "action": "edit",
 "title": "Project:Sandbox",
 "token": CSRF_TOKEN,
 "format": "json",
 "appendtext": "Hello"
}
R = S.post(URL, data=PARAMS_3)
DATA = R.json()
print(DATA)

PHP

<?php
/*
 edit.php
 MediaWiki API Demos
 Demo of `Edit` module: POST request to edit a page
 MIT license
*/
$endPoint = "https://test.wikipedia.org/w/api.php";
$login_Token = getLoginToken(); // Step 1
loginRequest( $login_Token ); // Step 2
$csrf_Token = getCSRFToken(); // Step 3
editRequest($csrf_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 CSRF token
function getCSRFToken() {
	global $endPoint;
	$params3 = [
		"action" => "query",
		"meta" => "tokens",
		"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"]["csrftoken"];
}
// Step 4: POST request to edit a page
function editRequest( $csrftoken ) {
	global $endPoint;
	$params4 = [
		"action" => "edit",
		"title" => "Project:Sandbox",
		"appendtext" => "Hello",
		"token" => $csrftoken,
		"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

/* 
	edit.js

	MediaWiki API Demos
	Demo of `Edit` module: POST request to edit a page
	using OAuth
	MIT license
*/
varapiEndpoint='https://test.wikipedia.org/w/api.php';
varoauthToken="OAuth2AccessToken";// Replace with actual OAuth 2 token
// Helper function
asyncfunctionperformFetch(queryURL,options={}){
options.headers={'Authorization':'Bearer '+oauthToken};
constresponse=awaitfetch(queryURL,options);
consttext=awaitresponse.text();
try{
returnJSON.parse(text);
}catch(e){
console.error(e);
returntext
}
}
// Step 1: GET request to fetch CSRF token
functiongetCsrfToken(){
varparams_0={
action:'query',
meta:'tokens',
format:'json',
formatversion:'2',
crossorigin:''
};
varqueryURL=newURL(apiEndpoint);
queryURL.search=newURLSearchParams(params_0);
performFetch(queryURL,{method:'GET'})
.then(function(data){
varcsrf_token=data?.query?.tokens?.csrftoken;
if(csrf_token){
editRequest(csrf_token)
}else{
console.error("Error retrieving CSRF token!");
}
});
}
// Step 2: POST request to edit a page
// Action API requires data be posted as application/x-www-form-urlencoded (URLSearchParams)
// or multipart/form-data, rather than application/json (T212988)
functioneditRequest(csrf_token){
varparams_1={
action:'edit',
title:'Project:Sandbox',
appendtext:'test edit',
summary:'test edit',
format:'json',
formatversion:'2',
token:csrf_token,
crossorigin:''
}
varqueryURL=newURL(apiEndpoint);
varpostBody=newURLSearchParams();
Object.keys(params_1).forEach(key=>{
if(key=='action'||key=='origin'||key=='crossorigin'){
queryURL.searchParams.append(key,params_1[key]);
}else{
postBody.append(key,params_1[key]);
}
});
performFetch(queryURL,{method:'POST',body:postBody})
.then(function(data){
varresult=data?.edit?.result;
if(result){
console.log(result);
}else{
console.error("Error posting edit!");
}
});
}
// Start from Step 1
getCsrfToken();

Node.js

/* 
 edit.js

 MediaWiki API Demos
 Demo of `Edit` module: POST request to edit a page
 using Bot Passwords
 MIT license
*/
varrequest=require('request').defaults({jar:true}),
url="https://test.wikipedia.org/w/api.php";
// Step 1: GET request to fetch login token
functiongetLoginToken(){
varparams_0={
action:"query",
meta:"tokens",
type:"login",
format:"json"
};
request.get({url:url,qs:params_0},function(error,res,body){
if(error){
return;
}
vardata=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
functionloginRequest(login_token){
varparams_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;
}
getCsrfToken();
});
}
// Step 3: GET request to fetch CSRF token
functiongetCsrfToken(){
varparams_2={
action:"query",
meta:"tokens",
format:"json"
};
request.get({url:url,qs:params_2},function(error,res,body){
if(error){
return;
}
vardata=JSON.parse(body);
editRequest(data.query.tokens.csrftoken);
});
}
// Step 4: POST request to edit a page
functioneditRequest(csrf_token){
varparams_3={
action:"edit",
title:"Project:Sandbox",
appendtext:"test edit",
token:csrf_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

/*
	edit.js
	MediaWiki API Demos
	Demo of `Edit` module: POST request to edit a page
	MIT License
*/
varparams={
action:'edit',
title:'Project:Sandbox',
appendtext:'Hello',
format:'json'
},
api=newmw.Api();
api.postWithToken('csrf',params).done(function(data){
console.log(data);
});

bash (curl)

#!/usr/bin/env bash
# target wiki settings
# get this from Special:BotPassword
exportMW_USER=""
exportMW_PASS=""
# the url for the target wiki to import pages, end with /
exportMW_URL=""
# bot info, to be embeded in the page comments
exportBOT_INFO="mwpm"
# source wiki settings
# the source wiki url, for wikitext
exportSRC_URL=""
# file list for plain wikitext
FILE="1ドル"
# 0ドル <token type>
# mainly csrf and login
functionget-token(){
API_URL="api.php"
RESULT=$(curl-fsSL-XPOST\
-daction=query\
-dmeta=tokens\
-dtype="1ドル"\
-dformat=json\
-ccookie.txt\
-bcookie.txt\
"${MW_URL}${API_URL}")
#RESULT=${RESULT/*token\":\"}
#TOKEN=${RESULT%\\\"*}
TOKEN=$(jq-r".query.tokens[\"${1}token\"]"<<<"$RESULT")
echo"$TOKEN"
}
# 0ドル <wiki-url> <username> <password>
functionmw-login(){
API_URL="api.php"
curl-fsSL-XPOST\
--data-urlencodeaction=login\
-dlgname="2ドル"\
-dlgpassword="3ドル"\
--data-urlencodelgtoken=$(get-tokenlogin)\
-dformat=json\
-ccookie.txt\
-bcookie.txt\
"${1}${API_URL}"
}
# 0ドル <file> <command>
# every line is in the $trimmed_line variable
functionbatch-process(){
whileIFS=read-rline;do
trimmed_line=$(echo"$line"|sed-e's/^[[:space:]]*//'-e's/[[:space:]]*$//')
if[[-z"$trimmed_line"]];then
continue
fi
if[["$trimmed_line"=~^#]];then
continue
fi
eval2ドル
done<"1ドル"
}
# Check if the file exists
if[[!-f"$FILE"]];then
echo"Error: File '$FILE' not found."
exit1
fi
functionplain-import(){
page_name="1ドル"
content_file="2ドル"
page_content="$(cat$content_file)"
echo"+++ writting page $page_name +++"
API_URL="api.php?action=edit&format=json"
curl-fsSL-XPOST\
-d"summary=$BOT_INFO$MW_PREF"\
-d"title=$page_name"\
--data-urlencode"text=${page_content}"\
-d"bot=true"\
--data-urlencode"token=$(get-tokencsrf)"\
-ccookie.txt\
-bcookie.txt\
"${MW_URL}${API_URL}"
echo
}
# login to $MW_URL
echo"logging into $MW_URL"
mw-login"$MW_URL""$MW_USER""$MW_PASS"
echo
if[[$private_src=="true"]];then
echo"logging into $SRC_URL"
mw-login"$SRC_URL""$SRC_USER""$SRC_PASS"
echo
fi
SITE_NAME=${SRC_URL%/}
SITE_NAME=${SITE_NAME/https:\/\/}
FILE_NAME=$(basename"$FILE")
exportEXPORT_DIR="cache/$SITE_NAME/${FILE_NAME%.txt}"
echo"Processing lines from '$FILE'"
batch-process"$FILE"'plain-import "$trimmed_line" $EXPORT_DIR/"$trimmed_line".wikitext'
echo"Finished processing."

1. ↑ https://stackoverflow.com/a/4073451