أفضل الممارسات
ما يجعل التكامل يدوم.
- استخدم الوضع التدريجي (desde + depoisDe) للمزامنة: يجلب ما تغير فقط ولا يصل إلى الحد.
- عالج 429 بانتظار Retry-After مع تراجع أسي — لا تكرر في حلقة مغلقة أبداً.
- أرسل Idempotency-Key في كل POST: تنقطع الشبكة ويكرر روتينك ولا يتكرر شيء.
- تحقق من توقيع webhook قبل المعالجة؛ رد 2xx بسرعة وعالج لاحقاً.
- مفتاح لكل نظام متكامل بأصغر نطاق يكفي؛ ألغِ ما لا يُستخدم.
أشكال غير مناسبة
- مسح القائمة كاملة كل دقيقة — هذا ما يستبدله الوضع التدريجي.
- مشاركة مفتاح API مع المستخدمين النهائيين أو تضمينه في تطبيق هاتف أو صفحة عامة.
- الكتابة عبر API بلا مستخدم مسؤول على المفتاح — سيبقى المسار بلا مؤلف، لذلك 409.