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

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

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

| الخطة    | الطلبات في الدقيقة | الطلبات في اليوم |
| -------- | ------------------ | ---------------- |
| مجاني    | 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 Too Many Requests` كاستجابة. ينبغي لعميلك أن يخفف الطلبات ويعيد المحاولة بعد الوقت المشار إليه في ترويسة `Retry-After` .

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

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

إذا كانت حالة الاستخدام لديك تتطلب حدودًا أعلى، فإن ترقية خطتك هي الخطوة الأولى. بالنسبة إلى المتطلبات على مستوى Enterprise، [اتصل بنا](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://sexytrees.savimbo.com/practice-guide/ar/altkamlat/hdwd-madlat-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.