واجهة برمجة التطبيقات:ClearHasMsg

طلب GET الغرض منه إزالة وسم hasmsg عن المستخدم الحالي.

إصدار ميدياويكي:

≥ 1.24

توثيق واجهة برمجة التطبيقات

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 الذي ينتج عنه عرض بانر You have new messages ويرجع قيمته إلى true في استعلام HasMsg. يمكن للتطبيقات التي تسترجع صفحات النقاش مستخدمة واجهة برمجة التطبيقات استخدامه، وهو الأمر الذي يكون خلافًا لفتح صفحة نقاشك في متصفح، لا يزيل هذا الوسم آليًا.
• حينما تبدأ هذا التصرف، لن يظهر بانر You have new messages إلى أن تتلقى المزيد من الرسائل من مستخدمين آخرين.
• يتعين استخدام سبيل POST مع هذه الوحدة البرمجية منذ الإصدار ‎1.29.0-wmf.5.