حدود الاستخدام

كم طلباً تشمل خطتك، وكيف يعمل حد الإغراق في الثانية، وأي الطلبات مجانية.

حصة الخطة#

تشمل كل خطة عدداً من الطلبات في دورة الفوترة. كل استدعاء لدالة قابلة للاحتساب بمفتاح فعلي، ناجحاً كان أو فاشلاً، يُحتسب طلباً واحداً.

قد تتغير الخطط وحصصها؛ تعرض لوحة التحكم (https://gurdx.cretip.com/app) دائماً الأرقام الحالية واستهلاكك الفعلي.

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

Note: يُقرأ الاستهلاك من عدّاد يتحدّث تقريباً مرة كل دقيقة، لذا قد تنجح بضعة طلبات بعد الطلب الذي يتجاوز الحد قبل أن يبدأ الخطأ 103 بالظهور.

حد الإغراق#

بصرف النظر عن الحصة، يُسمح لكل حساب بما لا يزيد عن 1,000 طلب في الثانية. فوق ذلك تعيد الواجهة الخطأ 106 flood_detected. يتصفّر العدّاد كل ثانية، فيكفي توقف قصير.

async function call(url, tries = 3) {
  const res = await fetch(url).then((r) => r.json());
  if (res.status === "error" && res.code === 106 && tries > 0) {
    await new Promise((r) => setTimeout(r, 300));
    return call(url, tries - 1);
  }
  return res;
}

الطلبات بالجملة#

تقبل فحص عناوين IP بالجملة عدة عناوين في استدعاء HTTP واحد، فتقلّ الرحلات وتبقى تحت حد الإغراق. يُحتسب الاستدعاء طلباً واحداً.

ما لا يُحتسب#

• الطلبات في وضع الاختبار (mode=test أو مفتاح gx_test_). فهي مجانية ولا تولّد أحداثاً.
• حذف بيانات مستخدم فهي غير قابلة للاحتساب.
• الطلبات التي تفشل قبل إثبات المفتاح، مثل الخطأ 101، لأنه لا يمكن نسبتها إلى حساب.

الوصول حسب الخطة#

قد تقيّد الخطة الدوال والوحدات المسموحة لك:

• استدعاء دالة خارج خطتك يعيد الخطأ 117 feature_not_available.
• طلب params=security دون وحدة الأمان يعيد الخطأ 114 security_module_not_allowed. راجع كشف VPN والوكيل.

حالة الاشتراك#

كيف تضبط استهلاكك#

• خزّن مؤقتاً النتائج بطيئة التغير مثل بيانات الدولة وBIN.
• استخدم الاستعلام بالجملة عند وجود عناوين كثيرة.
• طوّر بمفتاح gx_test_ حتى لا تستهلك اختباراتك من الحصة.
• راقب مخطط الاستخدام في لوحة التحكم ونبّه نفسك قبل بلوغ الحد.