Ga naar de inhoud
ShopentlyLearn

Veilig schrijven

Combineer idempotentiesleutels en versiecontroles voor voorspelbare wijzigingen.

Aan de slag

  1. Lezen

    Lees een resource vóór wijziging en stuur expected_version zoals gedocumenteerd.

  2. Schrijven

    Gebruik POST om ondersteunde resources aan te maken, PATCH voor gedeeltelijke wijzigingen en DELETE voor ondersteunde verwijderingen.

  3. Antwoord

    Een herhaalde geslaagde bewerking geeft het opgeslagen resultaat terug zonder de wijziging opnieuw uit te voeren.

Headers

Idempotency-Key
Elke schrijfbewerking op een resource vereist Idempotency-Key. Genereer één sleutel per logische bewerking; behoud sleutel, methode, doel en inhoud wanneer u die bewerking herhaalt.
expected_version
Prijswijzigingen kunnen ook product-, prijs-, variantprijs- of prijslijstversies vereisen. Lees bij een versiewijziging opnieuw en stem de wijziging af op de huidige gegevens, in plaats van verouderde gegevens af te dwingen.

Beleid voor opnieuw proberen

  • Dezelfde sleutel voor een ander verzoek geeft idempotency.key_reused.
  • Alle voorbeelden zijn synthetisch; vervang identificaties vóór uitvoering door waarden uit uw eigen winkel.