حد الطلبات
| المسار | الحد |
|---|---|
/api/v1/search/suggest | 90 طلبًا في 60 ثانية لكل عنوان |
/dl/{id} | 120 تحميلًا في 60 ثانية لكل عنوان |
| باقي المسارات | بلا حد، والردود مخزّنة مؤقتًا |
النافذة ثابتة: تبدأ مع أول طلب وتنتهي بعد مدتها. كل رد من المسارين المحدودين فيه:
X-RateLimit-Limit: الحد.X-RateLimit-Remaining: الباقي في هذه النافذة.X-RateLimit-Reset: متى تنتهي النافذة، بالثواني منذ 1970 (Unix).
وعند تجاوزه: 429 وRetry-After بعدد الثواني الباقية.
التخزين المؤقت
كل رد يقول كم يبقى صالحًا في Cache-Control. السجل يبقى دقيقة في المتصفح وعشر دقائق في الشبكة، والقائمة دقيقة وخمس دقائق، والاقتراحات نصف دقيقة ودقيقة.
لذلك قد لا يظهر تعديل في الأرشيف فورًا: الرد المخزّن يبقى حتى تنتهي مدته، ثم يُقدَّم قديمًا قليلًا بينما يُجدَّد (stale-while-revalidate).
إن كنت تعرض السجل نفسه لكل زوارك، خزّنه عندك عشر دقائق بدل طلبه في كل زيارة. القيم الدقيقة لكل مسار في المرجع.