أخطاء الواجهة وطرق معالجتها

ابدأ برمز حالة HTTP. تتضمن أخطاء البوابة عادةً رسالة detail داخل JSON، وترويسة X-Error-Code لسبب الخطأ البرمجي، وترويسة X-Request-Id لتحديد الطلب. قد لا تتوفر هذه البيانات عند انقطاع الاتصال أو صدور الخطأ من خادم وسيط.

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

عالج مشكلة البيانات أو المفتاح أو الرصيد أولًا عند ظهور 400 أو 401 أو 402 أو 404 أو 413. عند 429 أو 502 أو 503، أعد المحاولة عددًا محدودًا من المرات مع زيادة الانتظار تدريجيًا، وتجنب تشغيل محاولات متوازية. إذا انقطع الاتصال بعد الإرسال، فقد تكون نتيجة الطلب غير معروفة؛ وقد يؤدي إرساله مجددًا إلى توليد جديد وتكلفة جديدة.

عند التواصل مع الدعم، أرسل معرّف الطلب وعنوان الواجهة ورمز الحالة والوقت التقريبي. لا ترسل مفتاح الواجهة أو التسجيل نفسه.