API:Rollback/fr

Requête POST pour annuler les dernières séries de modifications faites par un utilisateur sur une page donnée.



Exemple
Toute requête POST est un processus en plusieurs étapes :

 Connectez-vous, via l'une des méthodes décrites dans . Obtenir un :

 Envoyer une requête POST, avec le jeton CSRF, pour faire l'action sur une page et dans ce processus gagner les droits  sur la page donnée :

 GET a rollback token: Si votre wiki utilise MediaWiki 1.24+, veuillez suivre ces instructions :

 Les jetons d'annulation ne sont pas universels; ils changent à chaque connexion et dépendent également du titre de la page et du nom de l'utilisateur dont les modifications sont révoquées. Pour MediaWiki 1.23 et précédent, suivre ces instructions :

   </ol>

<span id="POST_request">

Requête POST
Envoyer une requête POST, avec un jeton d'annulation pour annuler les modifications d'un utilisateur sur la page du bac à sable (sandbox).

Réponse
La section Réponse ci-dessous concerne la requête POST finale, pour annuler les modifications sur la page du bac à sable.

Les IDs de révision dans la réponse sont :
 *   - L'ID de la nouvelle révision créée par l'annulation.
 *   - L'ID de la révision la plus récente à annuler. Avant l'annulation, c'était la version actuelle.
 *   - L'ID de la révision à restituer par l'annulation. Ce sera la nouvelle révision restaurée.

<span id="Sample_code">

Permissions
La révocation nécessite à la fois que les droits  et   soient assignés sur la page cible; aujourd'hui cela signifie que les clients OAuth, les mots de passe des robots, etc... ont besoin simultanément des droits   et   – et   seul n'est pas suffisant !

<span id="Possible_errors">

Erreurs possibles
En supplément aux erreurs classiques:

<span id="Parameter_history">

Historique des paramètres

 * v1.24:  ajouté
 * v1.27:  ajouté
 * v1.17:  ajouté

<span id="Additional_notes">

Notes additionnelles

 * Optionnellement, aussi bien la révocation que les modifications étant révoquées peuvent être marquées comme étant faite par un robot, afin de les masquer des modifications récentes par défaut.

<span id="See_also">

Voir aussi

 * - Modifie une page.
 * - Contient des liens utiles sur la manière de modifier des articles.
 * - Comporte davantage de détails sur l'utilisation des jetons pour se connecter ou pour faire des requêtes POST.
 * - Une API obsolète, différente de, pour demander des jetons dans les anciennes versions de MediaWiki.
 * - Révoque les fichiers dans un état antérieur.
 * - Supprime et restaure les versions d'une page.
 * - Vous permet de faire des diffs entre les modifications d'une page.