API:ClearHasMsg/fr

From mediawiki.org
This page is a translated version of the page API:ClearHasMsg and the translation is 100% complete.

Requête GET pour réinitialiser le drapeau hasmsg pour l'utilisateur actuel.

Version de MediaWiki :
1.24

Documentation de l'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.

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

Exemple

Requête POST

Retire le drapeau hasmsg de l'utilisateur actuel.


Réponse

{
    "clearhasmsg": "success"
}

Exemple de code

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

Erreurs possibles

Code Info
mustbeposted Le module clearhasmsg nécessite une requête POST.

Notes supplémentaires

  • L'action clearhasmsg retirera le drapeau HasMsg, qui cause l'apparition du bandeau « Vous avez de nouvaux messages » et renvoie true lors d'une requête HasMsg. Il peut être utilisé par des applications qui récupèrent la page de discussion en utilisant l'API, et qui, à la différence du fait d'ouvrir votre page de discussion dans un navigateur, ne retirent pas automatiquement ce drapeau.
  • Quand vous effectuez cette action, le bandeau « Vous avez de nouveaux messages » n'apparaîtra plus jusqu'à ce que vous receviez de nouveaux messages de la part d'autres utilisateurs.
  • Ce module doit être appelé par une requête de type POST depuis la version 1.29.0-wmf.5.[1]

Références