> ## Documentation Index
> Fetch the complete documentation index at: https://docs.pubrio.com/llms.txt
> Use this file to discover all available pages before exploring further.

# حدّ معدل الطلبات

> حدّ معدل الطلبات لضمان استقرار الخدمة وموثوقيتها.

## إجمالي طلبات API

يخضع إجمالي طلبات API لديك لتفاصيل خطة Pubrio الحالية الخاصة بك. للاطلاع على حدود طلباتك الشهرية، راجع تفاصيل تسعير Pubrio API.

تعتمد Pubrio أسلوب حدّ معدل بنافذة ثابتة لاستدعاءات API. على سبيل المثال:

| نوع الاشتراك            | استدعاءات API (كل ساعة) | استدعاءات API (يوميًا) | استدعاءات API (شهريًا) |
| ----------------------- | ----------------------- | ---------------------- | ---------------------- |
| المجاني                 | `60`                    | `1,440`                | `44,640`               |
| النمو (Growth)          | `6,000`                 | `144,000`              | `4,464,000`            |
| الأعمال (Business)      | `60,000`                | `1,440,000`            | `44,640,000`           |
| المؤسسات (Organization) | `مخصص`                  | `مخصص`                 | `مخصص`                 |

تُحتسب استدعاءات API على أساس الاستهلاك، أي أنه إذا كان لديك عدة مستخدمين ضمن نفس مساحة العمل (أي المؤسسة)، فستكون استدعاءات API مضاعفة بعدد تراخيص المستخدمين.

## حدّ المعدل

تفرض Pubrio API حدًا لمعدل الطلبات لضمان استقرار الخدمة وموثوقيتها. وهو حدّ ذو نافذة ثابتة يبلغ 3,000 طلب في الدقيقة.

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

## التحقق من استخدامك

استدعِ [Profile Usage](/ar/api-reference/endpoint/profile/profile-usage) لقراءة استهلاكك الحالي وحدودك القصوى دون الحاجة إلى التخمين من الجدول أعلاه.

| الحقل                                                                                      | المعنى                                                                                           |
| ------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------ |
| `api_hourly_usage` / `api_daily_usage` / `api_monthly_usage`                               | استدعاءات API المستهلكة في النافذة الحالية                                                       |
| `max_api_hourly_query` / `max_api_daily_query` / `max_api_monthly_query`                   | الحد الأقصى لكل ترخيص ضمن خطتك لكل نافذة                                                         |
| `total_max_api_hourly_query` / `total_max_api_daily_query` / `total_max_api_monthly_query` | الحد الأقصى لكل ترخيص مضروبًا في عدد المقاعد لديك — وهو الحد الذي يُطبَّق فعليًا على مساحة العمل |
| `api_last_refreshed`                                                                       | آخر وقت أُعيد فيه ضبط العدادات                                                                   |

توجد نفس المجموعات الأربع بادئة بـ `portal_` لاستخدام لوحة التحكم، والتي تُقاس بشكل منفصل عن استخدام API.

<Tip>
  قارن `api_monthly_usage` بـ `total_max_api_monthly_query`، وليس بـ `max_api_monthly_query` — فالأرقام ذات بادئة `total_` تأخذ بالفعل مُضاعف التراخيص الموضّح أعلاه بعين الاعتبار.
</Tip>

## حدود الخطة

كل حدّ أقصى قادر على رفض طلب يُعاد بواسطة [Profile](/ar/api-reference/endpoint/profile/profile) ضمن `subscription`. اقرأ هذه القيم بدلًا من ترميزها ثابتة — فهي تختلف حسب الخطة.

| الحقل                                                                | ما يحكمه                                                                                             |
| -------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------- |
| `max_search_per_page`                                                | أكبر قيمة مقبولة لـ `per_page`. تجاوزها يُعيد HTTP 416 (`41676`، أو `41613` في بحث الشركات والأشخاص) |
| `max_search_page`                                                    | أعلى قيمة مقبولة لـ `page` في معظم عمليات البحث                                                      |
| `max_company_search_page`                                            | أعلى قيمة مقبولة لـ `page` في بحث الشركات تحديدًا                                                    |
| `max_display_search_page`                                            | عدد الصفحات المُعاد في `pagination.total_display_pages`                                              |
| `max_company_search_select_limit` / `max_people_search_select_limit` | أكبر قيمة لـ `select_size` في التحديد الجماعي                                                        |
| `max_export_limit` / `max_statistic_export_limit`                    | الحد الأقصى لعدد الصفوف في التصدير                                                                   |
| `max_record_upload_size`                                             | أكبر حجم رفع مقبول                                                                                   |
| `max_expansion_window_days`                                          | أوسع نافذة تاريخ في نقاط نهاية التوسّع (`null` = بلا حدود)                                           |
| `max_expansion_markets_preview`                                      | عدد الأسواق المُعادة قبل أن يُقلّصها `other_markets_locked_count` (`null` = بلا حدود)                |
| `max_expansion_comparison_peers`                                     | عدد النظراء المُعاد في مقارنة التوسّع (`null` = بلا حدود)                                            |

<Warning>
  تجاوز أي حدّ هو **HTTP 416**، وليس 400، ولا يُقتطع مجموعة النتائج بصمت أبدًا — بل يفشل الطلب مباشرة. راجع [رموز الحالة](/ar/api-reference/status-codes).
</Warning>