حدود المعدل والقيود وأخطاء واجهة برمجة التطبيقات

الحد من المعدل

يقتصر كل مفتاح API على عدد من الطلبات في الدقيقة حسب خطتك: Starter 60، Business 180، Pro 500، Enterprise 1200 طلب/دقيقة. عند تجاوز ذلك، تعرض واجهة برمجة التطبيقات الخطأ 429 Too Many Requests مع الترويسة Retry-After (60 ثانية) والترويسات X-RateLimit-Limit وX-RateLimit-Remaining وX-RateLimit-Reset. قد تطلب الحسابات ذات الحجم الكبير زيادة في هذا الحد. بالنسبة للإرسال الجماعي، تقبل نقطة bulk ما يصل إلى 10,000 رسالة في الطلب الواحد.

رموز استجابة HTTP الشائعة

• 200 OK — تمت معالجة الطلب بنجاح
• 400 Bad Request - معلمة مفقودة أو مشوهة (على سبيل المثال، رقم غير صالح)
• 401 Unauthorized - مفتاح API مفقود أو غير صالح
• 402 Payment Required - الرصيد غير كافٍ
• 429 Too Many Requests - تم تجاوز الحد الأقصى للمعدل
• 500 Internal Server Error - خطأ من جانب المنصة، اتصل بالدعم مع ذكر وقت الطلب وerror.code الذي تم إرجاعه

أفضل الممارسات

• تنفيذ منطق إعادة المحاولة مع التراجع الأسي على الأخطاء 429 و500
• قم بتسجيل message_id الذي تم إرجاعه بشكل منهجي لتسهيل أي تشخيص مستقبلي
• استخدم وضع الحماية لاختبار التكامل دون استهلاك أرصدة حقيقية أو إرسال رسائل حقيقية