HTTP 409 Conflict
Code d'état 409 · Classe 4xx
Message officiel (tel qu'affiché à l'écran) : Conflict
Aussi recherché sous la forme : error 409, HTTP 409, 409 conflict
Ce que cela signifie
La requête n’a pas pu être menée à bien car elle entre en conflit avec l’état actuel de la ressource. Les API renvoient 409 lorsque vous tentez de créer quelque chose qui existe déjà, de modifier un enregistrement changé par quelqu’un d’autre, ou d’effectuer une action interdite dans l’état actuel.
S'applique à : API REST, WebDAV, API d’hébergement Git
Comment corriger HTTP 409 Conflict
- Actualisez les données et relancez la modification à partir de la dernière version
- Lisez le corps de la réponse : les API bien conçues indiquent quel champ ou quelle version est en conflit
- Si vous créez une ressource, vérifiez qu’elle n’existe pas déjà (nom d’utilisateur, adresse e-mail ou identifiant en double)
- Si l’API utilise des ETag, envoyez la valeur actuelle dans 'If-Match' et réessayez après avoir récupéré la dernière copie
- Pour les clients de synchronisation de fichiers ou WebDAV, résolvez manuellement la copie en conflit
- Si vous êtes propriétaire de l’API : renvoyez un message d’erreur clair et la version actuelle de la ressource afin que les clients puissent se corriger
Pourquoi cela se produit
La RFC 9110 emploie le code 409 pour les conflits avec l’état actuel de la ressource visée : en général des modifications simultanées, des contraintes d’unicité et des transitions d’état invalides.
FAQ
Le code 409 est-il une erreur du serveur ?
Non. C’est un code 4xx côté client : la requête est valide, mais elle entre en conflit avec des données existantes et doit être modifiée ou renvoyée.
Erreurs liées
Source : IANA HTTP Status Code Registry · solutions rédigées et vérifiées par les éditeurs (voir notre politique éditoriale)
Dernière mise à jour :