API:ClearHasMsg

GET-Abfrage um die hasmsg-Markierung für den aktuellen Benutzer zu entfernen.

MediaWiki Version:

≥ 1.24

API-Dokumentation

action=clearhasmsg (main | clearhasmsg) This module requires read rights. This module requires write rights. This module only accepts POST requests. Source: MediaWiki License: GPL-2.0-or-later Clears the hasmsg flag for the current user. https://www.mediawiki.org/wiki/Special:MyLanguage/API:ClearHasMsg Example: Clear the hasmsg flag for the current user. api.php?action=clearhasmsg [open in sandbox]

Beispiel

POST-Anfrage

Entfernt die hasmsg-Markierung für den aktuellen Benutzer.

api.php?action=clearhasmsg [In der ApiSandbox ausprobieren]

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.