Treci la conținut
ShopentlyLearn

Scrieri sigure

Combinați cheile de idempotență cu verificarea versiunilor pentru actualizări previzibile.

Primii pași

  1. Citire

    Citiți resursa înainte de editare și furnizați expected_version conform documentației.

  2. Scriere

    Folosiți POST pentru crearea resurselor acceptate, PATCH pentru actualizări parțiale și DELETE pentru ștergerile acceptate.

  3. Răspuns

    Repetarea unei operații reușite returnează rezultatul salvat fără aplicarea din nou a modificării.

Antete

Idempotency-Key
Fiecare scriere asupra unei resurse necesită Idempotency-Key. Generați o cheie pentru fiecare operație logică; la reîncercare, repetați aceeași cheie, metodă, destinație și aceleași date.
expected_version
Schimbările de preț pot necesita și versiunile produsului, prețului, prețului variantei sau listei de prețuri. Dacă o versiune se schimbă, citiți din nou și adaptați actualizarea, fără a impune date învechite.

Reguli de reîncercare

  • Refolosirea unei chei pentru o altă cerere produce idempotency.key_reused.
  • Exemplele conțin date fictive; înlocuiți identificatorii cu valori obținute din propriul magazin înainte de executare.