Quel code d'erreur HTTP devrais-je utiliser lorsque j'essaie d'insérer un objet déjà existant?

Question

Je suis en train de concevoir une API REST. Certaines méthodes de cette API sont utilisées pour insérer de nouvelles données à l'aide de la méthode POST. Je me demande quel code d'erreur retourner quand l'insertion entraînerait l'insertion de données dupliquées? J'ai essayé de regarder la référence du code d'erreur, mais étant assez nouveau pour REST et HTTP, je ne suis pas sûr de savoir lequel utiliser.

Answer 1

409 Conflict semble approprié dans ce cas.

Le W3C status code definitions document dit:

10.4.10 409 Conflit

La demande n'a pas pu être achevée en raison d'un conflit avec l'état actuel de la ressource. Ce code n'est autorisé que dans les situations où il est prévu que l'utilisateur puisse résoudre le conflit et renvoyer la demande. Le corps de la réponse DEVRAIT contenir suffisamment d'informations pour que l'utilisateur reconnaisse la source du conflit. Idéalement, l'entité de réponse doit inclure suffisamment d'informations pour que l'utilisateur ou l'agent utilisateur puisse résoudre le problème; Cependant, cela peut ne pas être possible et n'est pas requis.