API:ClearHasMsg
Diese Seite ist Teil der Dokumentation der MediaWiki action API. |
GET-Abfrage um die hasmsg
-Markierung für den aktuellen Benutzer zu entfernen.
MediaWiki Version: | ≥ 1.24 |
API-Dokumentation
Beispiel
POST-Anfrage
Entfernt die
hasmsg
-Markierung für den aktuellen Benutzer.
Antwort
{
"clearhasmsg": "success"
}
Beispielcode
Python
#!/usr/bin/python3
"""
clear_has_msg.py
MediaWiki API Demos
Demo of `ClearHasMsg` module: Clear the hasmsg flag for the current user.
MIT License
"""
import requests
S = requests.Session()
URL = "https://en.wikipedia.org/w/api.php"
PARAMS = {
"action": "clearhasmsg",
"format": "json"
}
R = S.post(url=URL, data=PARAMS)
DATA = R.json()
print(DATA)
PHP
<?php
/*
clear_has_msg.php
MediaWiki API Demos
Demo of `ClearHasMsg` module: Clear the hasmsg flag for the current user.
MIT License
*/
$endPoint = "https://en.wikipedia.org/w/api.php";
$params = [
"action" => "clearhasmsg",
"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( $params ) );
curl_setopt( $ch, CURLOPT_RETURNTRANSFER, true );
curl_setopt( $ch, CURLOPT_COOKIEJAR, "cookie.txt" );
curl_setopt( $ch, CURLOPT_COOKIEFILE, "cookie.txt" );
$response = curl_exec($ch);
curl_close($ch);
echo ($response);
JavaScript
/*
clear_has_msg.js
MediaWiki API Demos
Demo of `ClearHasMsg` module: Clear the hasmsg flag for the current user.
MIT License
*/
var url = "https://en.wikipedia.org/w/api.php";
var params = {
action: "clearhasmsg",
format: "json"
};
request.post({ url: url, form: params }, function(error, res, body) {
if (error) {
return;
}
console.log(body);
});
MediaWiki JS
/*
clear_has_msg.js
MediaWiki API Demos
Demo of `ClearHasMsg` module: Clear the hasmsg flag for the current user.
MIT License
*/
var params = {
action: "clearhasmsg",
format: "json"
},
api = new mw.Api();
api.post( params ).done( function ( data ) {
console.log( data );
} );
Mögliche Fehler
Code | Information |
---|---|
mustbeposted | The clearhasmsg module requires a POST request. |
Zusätzliche Anmerkungen
- Die
clearhasmsg
-Aktion entfernt die HasMsg-Markierung, sodass das Banner "Sie haben neue Nachrichten" erscheint und in der HasMsg-Abfrage true ausgibt. Es kann von einer Anwendung genutzt werden, die die Diskussionsseite durch die API abruft, was anders als die Diskussionsseite im Browser zu öffnen, nicht automatisch diese Markierung entfernt. - Wenn man diese Aktion auslöst, erscheint das Banner "Sie haben neue Nachrichten" nicht, solange keine weiteren Nachrichten von anderen Nutzern empfangen werden.
- Seit 1.29.0-wmf.5. muss dieses Modul gePOSTed werden.[1]
Einzelnachweise
- ↑ BREAKING CHANGE: action=clearhasmsg will require POST auf der Mailingliste mediawiki-api-announce