> For the complete documentation index see https://domscan.net/llms.txt. Markdown versions of every docs page are available by appending .md to the page URL.

Source: https://domscan.net/ar/docs/rate-limits

# حدود المعدل

باستخدام DomScan API، تحمل كل استجابة مصرحة، سواء كانت ناجحة أو خطأ، هذه الرؤوس، ويمكن للمتصفحات قراءتها عبر CORS.

- **حسابات مجانية:** 300 طلب في الدقيقة، مع ذروة قصوى تبلغ 60. يتم مشاركة هذا الحد بين جميع مفاتيح API وجلسات لوحة المعلومات في الحساب.

- **حسابات مدفوعة:** 900 طلب في الدقيقة، مع ذروة قصوى تبلغ 120. يتم مشاركة هذا الحد بين جميع مفاتيح API وجلسات لوحة المعلومات في الحساب.

- **الخطط الشهرية للمؤسسات والاستخدام الكبير:** حدود مخصصة يتم الاتفاق عليها مع فريقنا بما يناسب حجم عملك. وطالما كان أحدها نشطاً، تتضمن `X-RateLimit-Policy` القيمة `custom` وتوضح المعدل المتفق عليه وسعة الاندفاع. [تحدث إلى المبيعات](https://domscan.net/ar/enterprise)

- **الطلبات بدون مفتاح API:** 600 طلب في الدقيقة لكل عنوان IP، مع اندفاع قدره 20.

- **نقاط نهاية المعالجة الجماعية على الحسابات المجانية:** 20 طلب إضافي في الدقيقة لكل حساب، و100 طلب في الدقيقة لكل شبكة.

- **الطلبات المخزنة مؤقتاً (prefer_cache=1):** لا تزال محسوبة ضد حد المعدل الخاص بك، لكنها توفر استجابة أسرع وتتجاوز البحث عن المصدر.

- **نقطة النهاية الجماعية:** 50 نطاقاً لكل طلب

- **عدد TLD في الطلب:** 50 maximum

يؤدي تجاوز الحد إلى إرجاع HTTP 429 مع رأس `Retry-After`. تحمل كل استجابة مصرحة `X-RateLimit-Limit` و`X-RateLimit-Remaining` و`X-RateLimit-Policy`، مما يسمح لك بتتبع ميزانيتك المتبقية بدلاً من التخمين.

### رؤوس حد المعدل

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

| الرأس | ما يخبرك به |
| --- | --- |
| `X-RateLimit-Plan` | الحد المطبق: `free` أو `paid` أو `standard` للطلبات بدون مفتاح API. |
| `X-RateLimit-Limit` | سعة الاندفاع لديك: عدد الطلبات التي يمكنك إرسالها دفعة واحدة. |
| `X-RateLimit-Remaining` | عدد الطلبات التي ما زال بإمكانك إرسالها الآن قبل تطبيق الحد. |
| `X-RateLimit-Reset` | وقت Unix بالثواني الذي تمتلئ فيه سعة الاندفاع لديك مجدداً. |
| `X-RateLimit-Policy` | السياسة الكاملة بصيغة قابلة للقراءة آلياً، مثل `paid; sustained=900; burst=120; scope=account; window=60`. |
| `Retry-After` | يُرسل مع HTTP 429: عدد الثواني التي يجب انتظارها قبل إعادة المحاولة. |
