البدء
قراءة
اقرأ المورد قبل تعديله، وأرسل expected_version وفق التوثيق.
كتابة
استخدم POST لإنشاء الموارد المدعومة، وPATCH للتحديثات الجزئية، وDELETE لعمليات الحذف المدعومة.
الاستجابة
تعيد العملية الناجحة المكررة نتيجتها المخزنة دون تطبيق التغيير مرة أخرى.
الترويسات
- Idempotency-Key
- تتطلب كل عملية كتابة على الموارد Idempotency-Key. أنشئ مفتاحًا واحدًا لكل عملية منطقية؛ وكرر المفتاح والطريقة والوجهة والمحتوى نفسها عند إعادة تلك العملية.
- expected_version
- قد تتطلب تغييرات الأسعار أيضًا إصدارات المنتج أو السعر أو أسعار المتغيرات أو قائمة الأسعار. إذا تغير إصدار، فأعد القراءة ووفّق التحديث مع الحالة الحالية بدلًا من فرض بيانات قديمة.
سياسة إعادة المحاولة
- تؤدي إعادة استخدام مفتاح لطلب مختلف إلى idempotency.key_reused.
- كل الأمثلة مصطنعة؛ استبدل المعرّفات بقيم مأخوذة من متجرك قبل تنفيذها.