API:Errors and warnings/fr

From mediawiki.org
Jump to navigation Jump to search

Si une requête à l'API ne se déroule pas correctement, une erreur ou un avertissement est retourné. Les avertissements sont retournés pour les anomalies non fatales telles que des paramètres invalides, tandis que les erreurs sont retournées pour les anomalies fatales.

Avertissements[edit]

Les avertissements sont retournés sous la forme suivante :

<?xml version="1.0" encoding="utf-8"?>
<api>
  <warnings>
    <query>Avertissement
Autre avertissement</query>
    <info>Avertissement concernant prop=info</info>
  </warnings>
</api>

Comme illustré par cet exemple, les avertissements sont groupés par le nom du module qui les a générés. Plusieurs avertissements provenant d'un même module sont séparés par un retour à la ligne.

Modules désactivés[edit]

Les sous-modules désactivés de action=query retournent l'avertissement suivant :

  • The ``modulename'' module has been disabled.

Avertissement de validation des paramètres[edit]

Les avertissements suivants peuvent être générés lors de la validation des paramètres, et peuvent donc être générés par tous les modules. paramname est remplacé par le nom du paramètre.

  • Too many values supplied for parameter 'paramname': the limit is limit
  • Unrecognized value for parameter 'paramname': value
  • Unrecognized values for parameter 'paramname': value1, value2, value3

Erreurs[edit]

Les erreurs sont générées dans le format suivant :

<error code="code" info="info" />

code est remplacé par le code d'erreur court (pas nécessairement unique à l'erreur) et info par une description plus élaborée de l'erreur (unique).

Messages d'erreur dans la documentation[edit]

Les messages d'erreur sont documentés comme suit :

  • code: apparams
    • info: prlevel may not be used without prtype

Qui correspond à:

<error code="apparams" info="prlevel may not be used without prtype" />

Modules désactivés[edit]

Les modules désactivés action= échouent avec l'erreur suivante :

  • code: moduledisabled
    • info: The ``modulename'' module has been disabled.

Erreurs de validation des paramètres[edit]

Les erreurs suivantes peuvent être générées lors de la validation des paramètres, et peuvent donc être générées par tous les modules. paramname est remplacé par le nom du paramètre.

  • code: multival_paramname
    • info: Only one of 'value1', 'value2', 'value3' is allowed for parameter 'paramname'
  • code: unknown_paramname
    • info: Unrecognized value for parameter 'paramname': value
  • code: paramname
    • info: paramname may not be set to less than min (set to value)
  • code: paramname
    • info: paramname may not be set over max (set to value) for bots and sysops
  • code: paramname
    • info: paramname may not be set over max (set to value) for users
  • code: badtimestamp_paramname
    • info: Invalid value value for timestamp parameter paramname
  • code: baduser_paramname
    • info: Invalid value value for user parameter paramname
  • code: invalidparammix
    • info: The parameters param1, param2, param3 cannot be used together
  • code: missingparam
    • info: One of the parameters param1, param2, param3 is required
  • code: _badcontinue
    • info: Invalid continue param. You should pass the original value returned by the previous query

Messages d'erreur standards[edit]

Quelques messages d'erreur génériques sont partagés entre les modules. Si un module peut lancer ce type d'erreur, celle-ci est explicitement mentionnée dans la section Possible errors.

  • code: unknownerror
    • info: Unknown error
      • Cela signifie généralement que quelque chose de bizarre s'est produit (ex: race condition). Si vous obtenez cette erreur, retentez la requête jusqu'à ce qu'elle soit réussie ou qu'elle retourne un message d'erreur plus explicite.
  • code: unknownerror
    • info: Unknown error errorcode
  • code: unsupportednamespace
    • info: Pages in the Special namespace can't be edited
  • code: protectednamespace-interface
    • info: You're not allowed to edit interface messages
  • code: protectednamespace
    • info: You're not allowed to edit pages in the ``namespace'' namespace
  • code: customcssjsprotected
    • info: You're not allowed to edit custom CSS and JavaScript pages
  • code: cascadeprotected
    • info: The page you're trying to edit is protected because it's included in a cascade-protected page
  • code: protectedpage
    • info: The ``right'' right is required to edit this page
  • code: permissiondenied
    • info: Permission denied
  • code: confirmemail
    • info: You must confirm your e-mail address before you can edit
  • code: blocked
    • info: You have been blocked from editing
  • code: autoblocked
    • info: Your IP address has been blocked automatically, because it was used by a blocked user
  • code: ratelimited
    • info: You've exceeded your rate limit. Please wait some time and try again
  • code: readonly
    • info: The wiki is currently in read-only mode
  • code: badtoken
    • info: Invalid token
  • code: missingtitle
    • info: The page you requested doesn't exist
  • code: mustbeposted
    • info: Type of your HTTP request message must be POST
  • code: hookaborted
    • info: The modification you tried to make was aborted by an extension hook
  • code: nosuchpageid
    • info: There is no page with ID id
  • code: nosuchrevid
    • info: There is no revision with ID id
  • code: nosuchrcid
    • info: There is no change with rcid ``id''
  • code: nosuchuser
    • info: The user you specified doesn't exist
  • code: invalidtitle
    • info: Bad title ``title''
  • code: invaliduser
    • info: Invalid username ``username''