Kom i gang
Lesing
Les ressursen før redigering, og oppgi expected_version som dokumentert.
Skriving
Bruk POST til å opprette støttede ressurser, PATCH til delvise oppdateringer og DELETE til støttede slettinger.
Svar
En gjentatt vellykket operasjon returnerer det lagrede resultatet uten å utføre endringen på nytt.
Headere
- Idempotency-Key
- Alle ressursendringer krever Idempotency-Key. Generer én nøkkel per logisk operasjon; gjenta samme nøkkel, metode, mål og innhold ved nytt forsøk på operasjonen.
- expected_version
- Prisendringer kan også kreve versjoner for produkt, pris, variantpris eller prisliste. Hvis en versjon endres, må du lese på nytt og avstemme oppdateringen i stedet for å tvinge gjennom utdaterte data.
Regler for nye forsøk
- Gjenbruk av en nøkkel til en annen forespørsel gir idempotency.key_reused.
- Alle eksemplene er syntetiske; erstatt identifikatorene med verdier fra din egen butikk før du kjører dem.