API:ClearHasMsg
Эта страница является частью документации по API действий MediaWiki. |
GET-запрос очищает флаг hasmsg
для текущего пользователя.
Версия MediaWiki: | ≥ 1.24 |
Документация по API
Пример
POST-запрос
Очищает флаг
hasmsg
для текущего пользователя.
Ответ
{
"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.[1]
Примечания
- ↑ КРИТИЧЕСКОЕ ИЗМЕНЕНИЕ: action=clearhasmsg будет требовать POST в рассылочном списке action=clearhasmsg