مرجع المطورين
حدود المعدل
باستخدام DomScan API، تحمل كل استجابة مصرحة، سواء كانت ناجحة أو خطأ، هذه الرؤوس، ويمكن للمتصفحات قراءتها عبر CORS.
حدود المعدل
- حسابات مجانية: 300 طلب في الدقيقة، مع ذروة قصوى تبلغ 60. يتم مشاركة هذا الحد بين جميع مفاتيح API وجلسات لوحة المعلومات في الحساب.
- حسابات مدفوعة: 900 طلب في الدقيقة، مع ذروة قصوى تبلغ 120. يتم مشاركة هذا الحد بين جميع مفاتيح API وجلسات لوحة المعلومات في الحساب.
- الخطط الشهرية للمؤسسات والاستخدام الكبير: حدود مخصصة يتم الاتفاق عليها مع فريقنا بما يناسب حجم عملك. وطالما كان أحدها نشطاً، تتضمن
X-RateLimit-Policyالقيمةcustomوتوضح المعدل المتفق عليه وسعة الاندفاع. تحدث إلى المبيعات - الطلبات بدون مفتاح 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: عدد الثواني التي يجب انتظارها قبل إعادة المحاولة. |