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

كل فشل له الشكل نفسه. فرّع على error.error_code؛ سجّل الوصف للقراءة البشرية؛ لا تطابق نصّه أبدًا. error.error_attributes يحمل التفاصيل التي يحددها الرمز، وهو لا قيمة للباقي.

{
  "description": "story_document: يقدّم الرابط \"text/html\"، وهذا الإدخال لا يقبله. وجّه إلى الملف نفسه.",
  "code": "url_type_not_allowed",
  "error": {
    "id": null,
    "error_code": "url_type_not_allowed",
    "error_attributes": null,
    "user_readable_message": null,
    "locale": "ar"
  }
}

الرمز يتكرر error.error_code للعملاء الأقدم؛ اقرأ error.error_code.

رموز الأخطاءCopy Anchor Link

الحدودCopy Anchor Link

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

الفوترةCopy Anchor Link

تُحاسَب أرصدة أي تشغيل بدأ عبر API على المؤسسة التي تملك المفتاح، وتُحتسب على المفتاح الذي بدأه. يرى المسؤول الإنفاق تحت الفوترة والاستخدام → نشاط الرصيد في Studio، وتظهر حدود كل مفتاح على مفاتيح API الصفحة.

يستمر احتساب التشغيل على المفتاح الذي بدأه حتى لو تدخل أحدهم في الدردشة داخل Studio وتولّى الأمر، لذا فإن الميزانية المتبقية للمفتاح هي ميزانية التشغيل بأكمله.

أي تشغيل يُرفض قبل أن يبدأ — رابط غير صالح، أو مفتاح أو مؤسسة بلا رصيد — لا يكلف شيئًا. أما التشغيل الذي يفشل في منتصفه فقد استهلك تكلفة ما اكتمل من خطواته؛ الأرصدة المستخدمة في التشغيل يوضح المقدار.