# حدود معدل واجهة برمجة التطبيقات والحصص

تحمي حدود المعدل استقرار المنصة وتضمن الاستخدام العادل عبر جميع العملاء. إذا كنت تبني تكاملاً أو أتمتة فوق واجهة برمجة التطبيقات الخاصة بنا، فمن المفيد فهم كيفية عملها.

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

| الخطة    | الطلبات في الدقيقة | الطلبات في اليوم |
| -------- | ------------------ | ---------------- |
| مجاني    | 60                 | 1,000            |
| احترافي  | 300                | 10,000           |
| الأعمال  | 1,000              | 100,000          |
| المؤسسات | مخصص               | مخصص             |

### ترويسات حدود المعدل

يتضمن كل رد من واجهة برمجة التطبيقات ترويسات تعرض استخدامك الحالي:

```
X-RateLimit-Limit: 300
X-RateLimit-Remaining: 241
X-RateLimit-Reset: 1714560000
```

`X-RateLimit-Reset` هو طابع زمني بنظام Unix يحدد وقت إعادة ضبط الحد الخاص بك.

### ما الذي يحدث عندما تتجاوز الحد

الطلبات التي تتجاوز حد المعدل تتلقى `429 طلبات كثيرة جدًا` كردّ. ينبغي لعميلك أن يتراجع ويعيد المحاولة بعد الوقت المشار إليه في ترويسة `Retry-After` .

{% hint style="warning" %}
قد يؤدي الاستمرار في إرسال الطلبات إلى واجهة برمجة التطبيقات بعد تلقي 429 إلى حظر مؤقت لمفتاح واجهة برمجة التطبيقات الخاص بك. طبّق دائمًا التراجع الأسي في تكاملك.
{% endhint %}

### زيادة حدودك

إذا كانت حالة الاستخدام الخاصة بك تتطلب حدودًا أعلى، فإن ترقية خطتك هي الخطوة الأولى. بالنسبة إلى متطلبات مستوى المؤسسات، [اتصل بنا](https://example.com/contact) لمناقشة الحصص المخصصة.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://isbm.savimbo.com/practice-guide/ar/altkamlat/hdwd-madl-wajhh-brmjh-alttbyqat-walhss.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.