أخطاء HTTP API الشائعة وكيفية إصلاحها
| رمز HTTP | السبب المحتمل | الحل |
|---|---|---|
| 400 | معلمة مفقودة أو غير صالحة (رقم منسق بشكل غير صحيح، حقل مطلوب مفقود، اسم مرسل غير صالح) | تحقق من تنسيق طلب JSON وتنسيق الأرقام (+212...) |
| 401 | مفتاح API مفقود أو غير صالح أو منتهي الصلاحية | تحقق من ترويسة Authorization وأعد إنشاء المفتاح إذا لزم الأمر |
| 402 | رصيد غير كافٍ في الحساب (INSUFFICIENT_BALANCE) |
اشحن حسابك (الشحن يدوي، ولا يوجد شحن تلقائي) |
| 403 | الإجراء غير مسموح به لمفتاح API هذا (تقييد النطاق/IP) | تحقق من الأذونات المرتبطة بالمفتاح المستخدم |
| 404 | لم يتم العثور على المورد (على سبيل المثال، message_id غير موجود) |
تحقق من المعرف المستخدم في عنوان URL |
| 429 | تم تجاوز حد المعدل (RATE_LIMITED) |
انتظر المهلة المحددة في ترويسة Retry-After (60 ثانية)، ثم أعد المحاولة مع تأخير تدريجي |
| 500 | خطأ داخلي على جانب المنصة | اتصل بالدعم مع ذكر وقت الطلب وerror.code الذي تم إرجاعه |
تشتمل كل استجابة للخطأ على نص JSON مع حقل error.code وerror.message الذي يوضح السبب بدقة.