Skip to main content

Signification

La requête était invalide sur le plan syntaxique ou sémantique : corps mal formé, champ obligatoire manquant ou valeur de paramètre hors de la plage autorisée. Lorsque le problème est attribuable à un seul paramètre, le champ param le désigne. Une réponse 409 signifie que la requête entre en conflit avec l’état actuel de la ressource. Par exemple, la création d’un client OAuth peut échouer parce que le compte de service cible est inactif, ne dispose pas d’une autorisation demandée ou a atteint sa limite de clients. Examinez status et detail ensemble : le code d’erreur seul ne permet pas de distinguer ces situations d’une requête mal formée.

Marche à suivre

  • Lisez detail et param : ils décrivent précisément ce qui a échoué à la validation.
  • Pour 400, corrigez la requête avant de la renvoyer.
  • Pour 409, résolvez d’abord le conflit lié à l’état du compte, à l’autorisation accordée ou à la capacité. Un client OAuth en attente de nettoyage occupe toujours de la capacité. Conservez la clé de nouvelle tentative lorsque vous réessayez la même tentative de création après avoir résolu le conflit.
  • Consultez la référence de l’API pour connaître les champs obligatoires, les types et les valeurs autorisées de l’opération.