API:Edit/fr

From MediaWiki.org
Jump to: navigation, search
Langue :Project:Language policy English  • Deutsch • español • français • 日本語 • русский • Tiếng Việt • 中文
Cette page fait partie de la documentation de l'API MediaWiki.

MediaWiki action API

v · d · e

Token[edit]

Pour éditer une page, un jeton d'édition (edit token) est requis. Ce token est le même pour toutes les pages - bien qu'il change à chaque connexion. Si vous voulez vous prémunir contre les conflits d'édition (ce qui serait sage), vous avez aussi besoin d'obtenir le timestamp de la dernière modification. Vous pouvez obtenir ces informations ainsi : Obtention du jeton d'édition

Édition de pages[edit]

Les pages peuvent être créées et éditées en utilisant le paramètre action=edit.

Paramètres[edit]

  • title: Page à éditer.
  • section: Section à éditer. Utilisez « 0 » pour la section d'introduction, « new » pour une nouvelle section.
  • text: Nouveau contenu de la page (ou de la section).
  • token: Jeton d'édition.
  • summary: Commentaire d'édition.
    • Avec section=new, ce paramètre sera utilisé pour le titre de la section.
  • minor: Si fourni, marque l'édition comme mineure.
  • notminor: Si fourni, ne marque pas l'édition comme mineure, même si vous avez l'option « Considérer mes modifications comme mineures par défaut » activée dans vos préférences.
  • bot: Si fourni, marque l'édition comme ayant été réalisée par un bot. Même si vous utilisez un compte avec le statut de bot, les éditions ne seront pas marquées comme telles sans ce paramètre.
  • basetimestamp: Timestamp de la dernière modification, utilisé pour détecter les conflits d'éditions. Ne pas fournir pour ignorer les conflits.
  • starttimestamp: Timestamp de l'obtention du jeton d'édition, utilisé pour détecter les conflits d'éditions. Ne pas fournir pour ignorer les conflits.
  • recreate: Si fourni, supprime les erreurs à propos des pages ayant été supprimés entre-temps et les recrée.
  • createonly: Si fourni, déclenche une erreur lorsque la page existe déjà.
  • nocreate: Si fourni, déclenche une erreur si la page n'existe pas encore.
  • watch: Si fourni, ajoute la page à la liste de suivi.
  • unwatch: Si fourni, supprime la page de la liste de suivi, ou ne l'ajoute pas même si vous avez l'option « Ajouter les pages que je modifie à ma liste de suivi » activée dans vos préférences.
  • md5: hash MD5 du paramètre text. Si ce paramètre est fourni et que les hash ne correspondent pas, l'édition est refusée. Ceci est utile pour se protéger des corruptions de données.
  • captchaid: ID du CAPTCHA de la précédente requête.
  • captchaword: Réponse au CAPTCHA
  • undo: ID de la modification à défaire. Passe outre les paramètres text, prependtext et appendtext.
  • undoafter: Défait toutes les modifications de undo jusqu'à undoafter, mais sans inclure ce dernier. Si non fourni, ne défait que la révision undo.

Exemple[edit]

Note: Dans cet exemple, tous les paramètres sont passés dans une requête GET, pour des raisons de simplicité. Toutefois, action=edit nécessite des requêtes POST ; les requêtes GET causeront une erreur. N'oubliez pas de mettre le header Content-Type de votre requête à la valeur application/x-www-form-urlencoded. Le jeton que vous recevez se termine par +\ : il doit être encodé (et donc terminé réellement par %2B%5C) avant d'être envoyé. Ajoute une nouvelle section à en:Talk:Main Page

CAPTCHAs et erreurs des extensions[edit]

Si une édition nécessite un CAPTCHA, vous obtiendrez quelque chose comme ceci :

<?xml version="1.0" encoding="utf-8"?>
<api>
  <edit result="Failure">
    <captcha type="math" mime="text/tex" id="509895952" question="36 + 4 = " />
  </edit>
</api>

Dans la majorité des cas, vous n'obtiendrez pas un CAPTCHA mathématique, mais l'URL d'une image CAPTCHA (dans le champ url). Quand vous avez résolu le CAPTCHA, réessayer la requête (en l'occurrence, avec captchaid=509895952&captchaword=40)

Les autres extensions qui utilisent l'APIEditBeforeSave-Hook peuvent retourner les erreurs dans le format décrit sur cette page ou bien dans le format d'erreur classique.

Erreurs possibles[edit]

En plus des erreurs classiques, les erreurs suivantes peuvent être rencontrées :

  • code: notitle
    • info: Le paramètre title doit être fourni.
  • code: notext
    • info: Un des paramètres text, appendtext, prependtext ou undo doit être fourni.
  • code: notoken
    • info: Le paramètre token doit être fourni.
  • code: invalidsection
    • info: Le paramètre section doit être un entier ou la chaine new
  • code: protectedtitle
    • info: Ce titre est protégé et la page ne peut être créée.
  • code: cantcreate
    • info: Vous n'avez pas la permission de créer de nouvelles pages.
  • code: cantcreate-anon
    • info: Les utilisateurs anonymes ne peuvent créer de nouvelles pages.
  • code: articleexists
    • info: L'article que vous tentez de créer existe déjà.
  • code: noimageredirect-anon
    • info: Les utilisateurs anonymes ne peuvent créer de redirections d'images.
  • code: noimageredirect
    • info: Vous n'avez pas la permission de créer des redirections d'images.
  • code: spamdetected
    • info: Votre édition a été refusée car elle contient un élément de spam : ``wikitext''
  • code: filtered
    • info: La fonction de filtre a refusé votre édition.
  • code: contenttoobig
    • info: Le contenu que vous envoyez dépasse la taille limite autorisée de bytes bytes.
  • code: noedit-anon
    • info: Les utilisateurs anonymes ne peuvent éditer d'articles.
  • code: noedit
    • info: Vous n'avez pas la permission d'éditer des articles
  • code: pagedeleted
    • info: La page a été supprimé entre-temps
  • code: emptypage
    • info: Créer une nouvelle page vide n'est pas autorisé.
  • code: emptynewsection
    • info: Créer une nouvelle section vide n'est pas autorisé.
  • code: editconflict
    • info: Un conflit d'édition a été détecté.
  • code: revwrongpage
    • info: rrevid n'est pas une modification de la page ``pagename''
      • (Apparait lorsqu'un ID invalide est fourni pour undo ou undoafter)
  • code: undo-failure
    • info: La modification n'a pas pu être défaite à cause d'éditions intermédiaires.