# حدود المعدل والحصص
SUMMARY: سياسة حدود المعدل لواجهة Synapse API — ترويسة Bearer (غير محدودة)، ?key= (60/دقيقة)، نقاط النهاية العامة.

KEY CONTEXT:
Mind Key (Authorization: Bearer header) → NO rate limit
Mind Key (?key= query param) → 60 req/min per IP
JWT (Authorization: Bearer header) → NO rate limit
Public endpoints (/tools/*, /docs, /health, /endpoints) → NO rate limit
Rate limit headers: X-RateLimit-Limit, X-RateLimit-Remaining, Retry-After
Recommendation: ALWAYS use Authorization header. Use ?key= only for URL-only tools.

حدود المعدل والحصص
يملك Synapse سياسة حدود معدل بسيطة وقابلة للتنبؤ مصممة لمنع إساءة الاستخدام
دون أن تعيق الاستخدام المشروع.
سياسة حد المعدل
| طريقة المصادقة | الحد | النطاق |
|-------------|-------|-------|
| Mind Key () | لا يوجد | لكل عقل |
| Mind Key () | 60 طلبًا/دقيقة | لكل IP |
| JWT () | لا يوجد | لكل مستخدم |
| نقاط النهاية العامة | لا يوجد | عام |
> [!TIP]
> استخدم دائمًا ترويسة  عندما يكون ذلك ممكنًا. ليس
> لها حد معدل. استخدم  فقط للأدوات التي لا تستطيع تعيين ترويسات مخصصة.
ترويسات حد المعدل
عند استخدام مصادقة ، تتضمن الاستجابات ترويسات حد المعدل:
[CODE BLOCK]
عند تجاوز الحد:
[CODE BLOCK]
عند بلوغ حد المعدل
إذا حصلت على 429:
1. بدّل إلى ترويسة Authorization (موصى به):
   [CODE BLOCK]
2. أو انتظر  ثانية وأعد المحاولة.
لماذا يوجد حد 
معامل الاستعلام  مريح للأدوات التي تفتح عناوين URL فقط (المتصفحات،
أوامر )، لكن له آثارًا أمنية وأدائية:
- الأمان: تُسجّل معاملات الاستعلام في سجلات الوصول للخادم، وبيانات
  المتصفح، وترويسات Referer. تحديد الاستخدام يقلل من التعرض.
- الأداء: تتطلب مصادقة معامل الاستعلام مُحدّد معدل قائم على IP
  (بحث Redis لكل طلب)، مما يضيف زمن استجابة. مصادقة الترويسة تتجاوز هذا.
- منع الإساءة: يمكن مشاركة عنوان URL  المُسرّب وقصفه بالطلبات.
  يُحجم حد IP دائرة الضرر.
الأنماط الموصى بها
وكلاء LLM
[CODE BLOCK]
أدوات المتصفح
إذا كانت أداتك تفتح عناوين URL فقط:
[CODE BLOCK]
خادم MCP
خوادم MCP تستخدم دائمًا مصادقة الترويسة عبر متغير البيئة 
— لا ينطبق حد معدل.
الاستيراد الكمي
للعمليات الكمية (مثل استيراد 1000 ذاكرة)، استخدم دائمًا مصادقة الترويسة.
الاستيراد الكمي عبر  سيبلغ حد المعدل خلال دقيقة واحدة.
الحصص (على مستوى العقل)
لا توجد حاليًا حصص على مستوى العقل لحجم التخزين أو عدد الذكريات. جميع
الحدود على مستوى المصادقة/IP، وليس على مستوى البيانات. قد يتغير ذلك
مستقبلًا لضمان العدالة في البيئات متعددة المستأجرين.
مراقبة الاستخدام
[CODE BLOCK]
الخطوات التالية
- المصادقة
- الأخطاء ومعالجتها