Comprendre l’usage de POST et PUT dans ERP Connector
Dans l’API ERP Connector / OnlineERP, la création et la mise à jour des entités respectent les standards RESTful.
-
POST : sert exclusivement à créer une ressource.
-
PUT : sert à créer ou remplacer une ressource à une URI donnée. Autrement dit, si la ressource existe, elle est remplacée ; si elle n’existe pas, elle est créée. Ce comportement est reconnu comme valide et conforme aux spécifications REST.
Cette approche suit la définition du verbe PUT telle que décrite dans la documentation HTTP officielle de MDN :
“The HTTP PUT request method creates a new resource or replaces a representation of the target resource with the request payload.”
Contrôler finement le comportement avec les préconditions HTTP
Il est également possible de restreindre le comportement de PUT à l’aide des headers standards :
-
If-Match: *→ autorise uniquement une mise à jour (erreur si la ressource n’existe pas). -
If-None-Match: *→ autorise uniquement une création (erreur si la ressource existe déjà).
Ces en-têtes font partie du standard HTTP et offrent un contrôle précis, sans nécessiter d’extensions propriétaires.