API:ClearHasMsg

From mediawiki.org
Jump to navigation Jump to search
This page is a translated version of the page API:ClearHasMsg and the translation is 72% complete.
Outdated translations are marked like this.
Other languages:
Afrikaans • ‎Deutsch • ‎Deutsch (Sie-Form)‎ • ‎English • ‎Türkçe • ‎español • ‎français • ‎polski • ‎български • ‎русский • ‎中文 • ‎日本語 • ‎한국어

GET request to clear hasmsg flag for the current user.

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.

Example:
Clear the hasmsg flag for the current user.
api.php?action=clearhasmsg [open in sandbox]

Beispiel

POST-Anfrage

Clear the hasmsg flag for the current user.

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

  • Diese 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.
  • This module must be POSTed since 1.29.0-wmf.5.[1]

Einzelnachweise