Premiers pas
Lecture
Lisez la ressource avant de la modifier et fournissez expected_version comme indiqué.
Écriture
Utilisez POST pour créer les ressources prises en charge, PATCH pour les modifications partielles et DELETE pour les suppressions disponibles.
Réponse
La répétition d'une opération réussie renvoie son résultat enregistré sans appliquer à nouveau la modification.
En-têtes
- Idempotency-Key
- Chaque écriture de ressource nécessite Idempotency-Key. Générez une clé par opération logique et conservez clé, méthode, cible et contenu lors de sa répétition.
- expected_version
- Les prix peuvent aussi exiger les versions du produit, du prix, des prix de variantes ou de la liste de prix. Si une version change, relisez et réconciliez la modification plutôt que de forcer des données obsolètes.
Règles de nouvelle tentative
- Réutiliser une clé pour une autre requête entraîne idempotency.key_reused.
- Les exemples sont synthétiques ; remplacez les identifiants par ceux de votre boutique avant de les exécuter.