منع التكرار
تفشل الشبكات أثناء الطلبات. ويتيح لك Idempotency-Key إعادة الطلب بأمان دون تنفيذه مرتين.
retry-safely
curl --request POST https://api.warka-iq.com/v1/capture-sessions \
--header "Authorization: Bearer $WARKA_KEY" \
--header "Idempotency-Key: 8f14e45f-attendance-7731" \
--header "Content-Type: application/json" \
--data '{"identity_id": "idn_..."}'- مدعوم في التسجيل وإنشاء جلسة الالتقاط والتحقق.
- يعيد التكرار الاستجابة الأولى ويضبط Idempotency-Replayed: true.
- المفتاح نفسه مع محتوى مختلف يعيد 422 idempotency_key_reused.
- الطلب الفاشل يحرر مفتاحه فتجري إعادة المحاولة بصورة طبيعية. وتدوم المفاتيح 24 ساعة.