API:ClearHasMsg

GET-запрос очищает флаг hasmsg для текущего пользователя.

Версия MediaWiki:

≥ 1.24

Документация по API

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]

Пример

POST-запрос

Очищает флаг hasmsg для текущего пользователя.

api.php?action=clearhasmsg [попробуйте в ApiSandbox]

Ответ

{
    "clearhasmsg": "success"
}

Пример кода

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 );
} );

Возможные ошибки

Код	Информация
mustbeposted	Модуль clearhasmsg требует запроса POST.

Дополнительная информация

• clearhasmsg обнулит флаг HasMsg, который приводит к возникновению надписи У вас есть новые сообщения и возвращает true в запросе HasMsg. Он может быть использован приложением, получающим страницу обсуждения через API, что, в отличие от открытия страницы обсуждения в браузере, не обнуляет флаг.
• Когда это действие произведено, надпись «У вас есть новые сообщения» исчезнет, до того как вы получите новое сообщение от другого участника.
• Начиная с версии 1.29.0-wmf.5, при использовании этого модуля нужно отправлять запрос с методом POST.