الأخطاء والحدود

للأخطاء شكل واحد:

{
  "error": {
    "type": "invalid_request_error",
    "code": "invalid_agent_field",
    "message": "status must be draft or published",
    "param": "status"
  }
}

الحالة	المعنى
400	إدخال غير صالح (يحدد code وparam أيَّ حقل)
401	مفتاح API مفقود أو غير صالح
402	رصيد غير كافٍ لبدء المكالمة
403	المفتاح للقراءة فقط، أو الوكيل غير متاح
404	لا يوجد وكيل أو مكالمة أو حملة بهذا المعرّف في مساحة العمل هذه
409	حالة غير صحيحة (مثل بدء حملة قيد التشغيل)، أو حساب مزوّد غير متصل، أو الرقم في قائمة عدم الاتصال (do_not_call)
429	طلبات كثيرة جدًا؛ خفّف الوتيرة وأعد المحاولة

تُعرض طلبات واجهة الصوت البرمجية لمساحة العمل خلال آخر 30 يومًا (الوقت ونقطة النهاية والحالة والمدة والمفتاح ورمز الخطأ؛ دون المحتوى) ضمن مفاتيح API ← سجل طلبات API.

القراءات محدودة بـ120 طلبًا في الدقيقة لكل مفتاح، والكتابات والمكالمات بـ30.

تُفوتَر المكالمات بالدقيقة من رصيد مساحة العمل، وهو الرصيد نفسه الذي تستخدمه لوحة التحكم. الأسعار الحالية في صفحة الأسعار.