التعامل مع أخطاء API وإعادة المحاولة وعدم التكرار (Idempotency)

صمّم تطبيقك ليتعامل مع الفشل، لا للمسار المثالي فقط. أخطر الحالات هي الحالة الغامضة، أي طلب قد يكون نجح أو لم ينجح قبل انقطاع الاتصال.

استخدم مفتاح عدم تكرار (idempotency key) في طلبات الطلب بحيث تُعيد إعادة المحاولة الآمنة بعد انتهاء المهلة الطلب الموجود بدلًا من إنشاء رسوم مكرّرة. أعد محاولة الأخطاء المؤقتة (حدود المعدّل، أخطاء 5xx المؤقتة) مع تراجع تدريجي متزايد وحد أقصى.

افشل سريعًا في الأخطاء الدائمة مثل الطلب الخاطئ أو الرصيد غير الكافي، واعرضها على إنسان، فإعادة محاولة هذه الأخطاء مجرد مضيعة للوقت. سجّل كل طلب واستجابة مع معرّف الطلب الخاص به حتى تتمكّن من التسوية لاحقًا.