Preskoči na sadržaj
ShopentlyLearn

Sigurni upisi

Kombinirajte ključeve idempotentnosti s provjerama verzije za predvidljiva ažuriranja.

Prvi koraci

  1. Čitanje

    Pročitajte resurs prije uređivanja i dostavite expected_version prema dokumentaciji.

  2. Pisanje

    Koristite POST za izradu podržanih resursa, PATCH za djelomična ažuriranja i DELETE za podržana brisanja.

  3. Odgovor

    Ponovljena uspješna operacija vraća spremljeni rezultat bez ponovne primjene promjene.

Zaglavlja

Idempotency-Key
Svaki upis resursa zahtijeva Idempotency-Key. Generirajte jedan ključ po logičkoj operaciji; pri ponavljanju zadržite isti ključ, metodu, cilj i podatke.
expected_version
Promjene cijena mogu dodatno zahtijevati verzije proizvoda, cijene, cijena varijanti ili cjenika. Ako se verzija promijeni, ponovno pročitajte podatke i uskladite ažuriranje umjesto nametanja zastarjelih podataka.

Pravila ponavljanja

  • Ponovna uporaba ključa za drugi zahtjev vraća idempotency.key_reused.
  • Svaki je primjer sintetički; prije izvršavanja zamijenite identifikatore vrijednostima iz vlastite trgovine.