حدود المعدل والحصص

يرتبط كل مفتاح finlight API بـباقة، وتحدّد الباقة حدود استخدامك والإمكانات التي يمكنك الوصول إليها. تُفرض الحدود لكل مفتاح API وفي الوقت الفعلي. توضّح هذه الصفحة كل حدّ وما تفتحه كل باقة؛ وللاطّلاع على الأرقام الدقيقة لباقتك، راجع لوحة تحكم finlight أو صفحة الأسعار.

حدود الاستخدام الأربعة

Name
حصة الطلبات الشهرية
Description
يستهلك كل طلب REST طلبًا واحدًا من مخصّصك الشهري. يُعاد ضبط العدّاد في بداية كل دورة فوترة. ويؤدّي تجاوزه إلى إرجاع 429 مع الرسالة "Exceeded token limit of N for the current period."
Name
معدل الدفعات
Description
حدّ قصير الأمد على عدد الطلبات لكل 10 ثوانٍ، يخفّف من الذُّرى المفاجئة. يُفرض فقط على الباقات التي تحدّده. ويؤدّي تجاوزه إلى إرجاع 429 مع الرسالة "Exceeded rate limit of N requests per 10 seconds." — تراجع نحو 10 ثوانٍ ثم أعد المحاولة.
Name
اتصالات WebSocket
Description
الحدّ الأقصى لعدد اتصالات WebSocket المتزامنة لمفتاحك. تُرفض الاتصالات الجديدة التي تتجاوز الحدّ. يحدّ سقف منفصل من إجمالي عدد الرسائل المتدفّقة لكل دورة. يتطلّب WebSocket باقة مدفوعة.
Name
حصة تسليم Webhook
Description
الحدّ الأقصى لعدد عمليات تسليم webhook لكل دورة فوترة. يحدّد حدّ مصاحب عدد عمليات webhook التي يمكنك إنشاؤها. وعند استنفاد حصة التسليم، تتوقّف عمليات التسليم مؤقتًا حتى الدورة التالية.

الإمكانات التي تفتحها باقتك

إلى جانب الحدود الأساسية، تتحكّم باقتك في الميزات المتاحة. ويؤدّي طلب ميزة لا تتضمّنها باقتك إلى إرجاع 403 (لـ REST) أو ببساطة حذف البيانات (لـ webhook/WebSocket).

Name
البيانات التاريخية
Description
يعتمد مدى رجوعك في الاستعلام على باقتك. تغطّي باقتا Free وPro Light حاليًا تقريبًا الشهر الأخير من المقالات؛ وتفتح الباقات الأعلى تغطية تاريخية أعمق. استخدم مرشّحي التاريخ from / to للاستعلام ضمن نافذة باقتك — أما طلبات التواريخ خارجها فتُرجع ببساطة عدم وجود نتائج لذلك النطاق. راجع صفحة الأسعار لمعرفة نافذة التاريخ الدقيقة لكل باقة.
Name
تحليل المشاعر
Description
يتضمّن الحقلين sentiment وconfidence في المقالات. ويُزالان من الحمولات عند عدم منحهما.
Name
كيانات الشركات
Description
يتضمّن مصفوفة companies (رموز محلولة بالذكاء الاصطناعي، وISIN، والبورصة، وغيرها) ويُفعّل includeEntities. ويُزال عند عدم منحه.
Name
المصادر المخصّصة
Description
مصادر أخبار خاصة أو خاصة بالعميل تُضاف إلى مجموعتك الافتراضية. متاحة في الباقات الأعلى / باقات المؤسسات.

كيف يعمل الفرض

لكل مفتاح، في الوقت الفعلي. يزيد كل طلب من عدّاداتك؛ وبمجرّد تجاوز أحد الحدود تُرجع الواجهة 429 فورًا.
استخدام لوحة التحكم ليس فوريًا. يُجمَّع الاستخدام المعروض في لوحة تحكم finlight نحو مرة واحدة يوميًا ويعكس النشاط حتى اليوم السابق — وهو ليس عدّادًا في الوقت الفعلي. أما الفرض فهو فوري، لذا قد تختلف حصتك المتبقّية الفعلية لليوم عمّا تعرضه لوحة التحكم.
تُعاد العدّادات الشهرية إلى الصفر في بداية دورة الفوترة — ويُمحى 429 الخاص بالحصة تلقائيًا.
لا توجد ترويسات لحدّ المعدل. لا يرسل finlight حاليًا ترويسات Retry-After أو X-RateLimit-*. تعامل مع 429 الدفعات على أنه "انتظر نحو 10 ثوانٍ"؛ وتعامل مع 429 الشهري على أنه "تم بلوغ الحصة لهذه الدورة". راجع الأخطاء ورموز الحالة.

الباقات

الباقة	الاستخدام النموذجي
Free	التقييم والاستخدام منخفض الحجم. REST فقط (بدون WebSocket).
Pro (Light / Standard / Scale)	أعباء عمل إنتاجية بحصص متزايدة، مع WebSocket وwebhooks وإثراء أغنى.
Enterprise	حجم كبير، ومصادر مخصّصة، وحدود مفصّلة حسب الطلب.

الحدود الرقمية الدقيقة (الرموز الشهرية، ومعدل الدفعات، واتصالات WebSocket، وحصة webhook) ومجموعة الميزات لكل باقة جزء من التسعير وقد تتغيّر. تحقّق دائمًا من حدود باقتك الحالية في لوحة تحكم finlight، أو قارن الباقات في صفحة الأسعار. هل تحتاج إلى حدود أعلى أو مصادر مخصّصة؟ تواصل معنا.

عند بلوغك أحد الحدود

429 الدفعات → توقّف مؤقتًا نحو 10 ثوانٍ ثم تابع.
429 الحصة الشهرية → لقد استهلكت طلبات دورتك؛ قم بالترقية أو انتظر إعادة الضبط.
رفض اتصال WebSocket → لقد بلغت سقف الاتصالات المتزامنة؛ أغلق اتصالًا خاملًا (راجع خيار takeover في بدء WebSocket السريع).
توقّف تسليم Webhook → استُنفدت حصة التسليم لهذه الدورة؛ وتُستأنف في الدورة التالية.
403 على إحدى الميزات → تلك الإمكانية ليست ضمن باقتك؛ راجع الجدول أعلاه.

للاطّلاع على نصوص الأخطاء الدقيقة، راجع الأخطاء ورموز الحالة.