انتقل إلى المحتوى
في هذه الصفحة

الحدود والتخزين المؤقت

كم طلبًا، وكم يبقى الرد صالحًا.

حد الطلبات

المسارالحد
/api/v1/search/suggest90 طلبًا في 60 ثانية لكل عنوان
/dl/{id}120 تحميلًا في 60 ثانية لكل عنوان
باقي المساراتبلا حد، والردود مخزّنة مؤقتًا

النافذة ثابتة: تبدأ مع أول طلب وتنتهي بعد مدتها. كل رد من المسارين المحدودين فيه:

  • X-RateLimit-Limit: الحد.
  • X-RateLimit-Remaining: الباقي في هذه النافذة.
  • X-RateLimit-Reset: متى تنتهي النافذة، بالثواني منذ 1970 (Unix).

وعند تجاوزه: 429 وRetry-After بعدد الثواني الباقية.

التخزين المؤقت

كل رد يقول كم يبقى صالحًا في Cache-Control. السجل يبقى دقيقة في المتصفح وعشر دقائق في الشبكة، والقائمة دقيقة وخمس دقائق، والاقتراحات نصف دقيقة ودقيقة.

لذلك قد لا يظهر تعديل في الأرشيف فورًا: الرد المخزّن يبقى حتى تنتهي مدته، ثم يُقدَّم قديمًا قليلًا بينما يُجدَّد (stale-while-revalidate).

إن كنت تعرض السجل نفسه لكل زوارك، خزّنه عندك عشر دقائق بدل طلبه في كل زيارة. القيم الدقيقة لكل مسار في المرجع.