الأرصدة وحدود المعدل

فوترة واجهة برمجة التطبيقات منفصلة عن حصص مهام خطة الويب. عند الاشتراك في خطة API، تحصل على مخصص رصيد شهري يُعاد تعيينه في تاريخ التجديد الخاص بك.

كيف تعمل الأرصدة

• يستهلك كل طلب API عددًا معينًا من الأرصدة حسب العملية وعدد الصفحات المعالجة.
• يُعاد تعيين الأرصدة إلى المخصص الشهري لخطتك في كل تاريخ تجديد.
• لا تُرحَّل الأرصدة غير المستخدمة إلى الشهر التالي.

ماذا يحدث عند نفاد الأرصدة

إذا لم يتبقَّ لحسابك أي رصيد، ترجع واجهة برمجة التطبيقات الرمز HTTP 402 Payment Required. ستستأنف طلباتك بمجرد إعادة تعيين الأرصدة في تاريخ التجديد التالي، أو فورًا إذا قمت بترقية خطة API الخاصة بك.

HTTP/1.1 402 Payment Required
{
  "code": 402,
  "message": "Insufficient credits. Please upgrade your plan."
}

حدود المعدل

لضمان الاستخدام العادل، تفرض واجهة برمجة التطبيقات حدود معدل لكل مفتاح API. إذا تجاوزت حد المعدل، ترجع واجهة برمجة التطبيقات الرمز HTTP 429 Too Many Requests. يتضمن الرد رأس Retry-After يشير إلى متى يمكنك الاستئناف.