İçeriğe atla
ShopentlyLearn

Güvenli yazma işlemleri

Öngörülebilir güncellemeler için idempotensi anahtarlarını sürüm denetimiyle birlikte kullanın.

Başlangıç

  1. Okuma

    Düzenlemeden önce kaynağı okuyun ve belgede açıklandığı gibi expected_version gönderin.

  2. Yazma

    Desteklenen kaynakları oluşturmak için POST, kısmi güncellemeler için PATCH ve desteklenen silme işlemleri için DELETE kullanın.

  3. Yanıt

    Başarılı bir işlemin tekrarı, değişikliği yeniden uygulamadan kayıtlı sonucu döndürür.

Başlıklar

Idempotency-Key
Her kaynak yazma işlemi Idempotency-Key gerektirir. Her mantıksal işlem için bir anahtar üretin; aynı işlemi yeniden denerken aynı anahtarı, yöntemi, hedefi ve verileri gönderin.
expected_version
Fiyat değişiklikleri ayrıca ürün, fiyat, varyant fiyatı veya fiyat listesi sürümlerini gerektirebilir. Sürüm değişirse verileri yeniden okuyup güncellemeyi uyarlayın; eski verileri zorla uygulamayın.

Yeniden deneme ilkesi

  • Anahtarın farklı bir istek için yeniden kullanılması idempotency.key_reused hatası verir.
  • Her örnek sentetiktir; çalıştırmadan önce tanımlayıcıları kendi mağazanızdan aldığınız değerlerle değiştirin.