Kom i gang
Læsning
Læs ressourcen før redigering, og angiv expected_version som dokumenteret.
Skrivning
Brug POST til at oprette understøttede ressourcer, PATCH til delvise opdateringer og DELETE til understøttede sletninger.
Svar
En gentaget vellykket operation returnerer sit gemte resultat uden at udføre ændringen igen.
Headere
- Idempotency-Key
- Alle ressourceændringer kræver Idempotency-Key. Generér én nøgle pr. logisk operation; gentag samme nøgle, metode, mål og indhold ved genforsøg på operationen.
- expected_version
- Prisændringer kan også kræve versioner for produkt, pris, variantpris eller prisliste. Hvis en version ændres, skal du læse igen og tilpasse opdateringen frem for at gennemtvinge forældede data.
Regler for genforsøg
- Genbrug af en nøgle til en anden forespørgsel giver idempotency.key_reused.
- Alle eksempler er syntetiske; erstat identifikatorerne med værdier fra din egen butik, før du udfører dem.