الحياد التكراري

تفشل استدعاءات الشبكة أحيانا. ولإعادة محاولة POST دون تنفيذ العمل - والدفع - مرتين، أرسل مفتاح حياد تكراري: قيمة فريدة تولدها لكل عملية منطقية (وUUID مناسب جدا).

curl -X POST https://developers.grem.capital/api/v1/valuation/express \
  -H "Authorization: Bearer gsk_live_xxx" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: 3f1c8a90-1e2b-4c77-9a10-2b6d0f9e4a11" \
  -d '{"propertyCategory":"apartment","totalArea":50}'

كيف يعمل

• الطلب الأول بمفتاح معين ينفذ عاديا وتخزن نتيجته مؤقتا.
• والتكرار بالمفتاح نفسه يعيد النتيجة الأصلية - فلا تشتغل الأداة ثانية ولا يحتسب عليك المبلغ مرة أخرى.
• وإن كان الطلب الأول ما زال جاريا أعاد التكرار 409 (تعارض في الحياد التكراري) - انتظر ثم أعد المحاولة.

وتحفظ المفاتيح 24 ساعة.