# الأسئلة الشائعة عن الـ API
SUMMARY: أسئلة شائعة عن الـ API — المصادقة، حدود المعدل، معالجة الأخطاء، اكتشاف نقاط النهاية.

الأسئلة الشائعة عن الـ API
أسئلة شائعة عن واجهة Synapse API.
كيف أُصادق؟
طريقتان:
1. Mind Key (لنقاط بيانات النهاية): 
2. JWT (لنقاط نهاية الحساب): 
أو عبر معامل الاستعلام (حد 60 طلبًا/دقيقة): 
راجع المصادقة.
ما الفرق بين Mind Key و JWT؟
- Mind Key: محدود بمستأجر، لا ينتهي، لبيانات الذاكرة/الدردشة/المهام
- JWT: محدود بالمستخدم، ينتهي بعد 7 أيام، لإدارة الحساب/العقل
راجع Mind Key مقابل JWT.
لماذا أحصل على 401 Unauthorized؟
أسباب شائعة:
1. ترويسة  مفقودة
2. Mind Key غير صالح (تحقق أنه يبدأ بـ )
3. استخدام JWT حيث يُطلب Mind Key (أو العكس)
4. تم إبطال Mind Key
الإصلاح: تحقق من رمزك. راجع المصادقة.
لماذا أحصل على 404 Not Found؟
استخدمت مسار نقطة نهاية خاطئًا. يمتلك Synapse فقط المسارات المذكورة في
.
الإصلاح: استدعِ  لرؤية جميع المسارات الصالحة. لا تخمّن.
لماذا أحصل على 429 Too Many Requests؟
تستخدم مصادقة معامل الاستعلام ، المحدودة بـ 60/دقيقة.
الإصلاح: بدّل إلى ترويسة  (بلا حد معدل).
راجع حدود المعدل.
كيف أُدرج جميع نقاط النهاية؟
[CODE BLOCK]
كيف أجد نقطة النهاية المناسبة؟
1. تحقق من  للقائمة القابلة للقراءة آليًا
2. تحقق من  لوثائق API الكاملة
3. تصفّح  لنظام الوثائق
4. استخدم  لمواصفات OpenAPI 3.0
هل يمكنني استخدام GET بدلًا من POST؟
بعض نقاط POST لها مكافئات GET للأدوات التي تفتح عناوين URL فقط:
-  ↔ 
-  ↔ 
-  ↔ 
تحقق من  لمتغيرات GET المتاحة.
كيف أتعامل مع الأخطاء؟
تُرجع جميع الأخطاء JSON:
[CODE BLOCK]
راجع الأخطاء ومعالجتها.
ما حد حجم نص الطلب؟
10 ميجابايت. للحمولات الأكبر (مثل رفع الملفات)، استخدم نقاط النهاية multipart.
هل يدعم الـ API CORS؟
نعم. جميع نقاط النهاية تُرجع:
[CODE BLOCK]
هل توجد حزمة SDK؟
نعم:
- Node.js: 
- MCP: 
راجع نظرة عامة على الـ API للتفاصيل.
كيف أتصفّح؟
استخدم  و :
[CODE BLOCK]
الحد الافتراضي: 100. الحد الأقصى: 500.
هل أستطيع تصفية الذكريات حسب الفئة أو الوسم؟
نعم:
[CODE BLOCK]
كيف أبحث في الذكريات؟
بطريقتين:
1. بحث FTS5 بالكلمات المفتاحية: 
2. البحث الدلالي: 
راجع بحث FTS5 و البحث الدلالي.
كيف أُحدّث ذاكرة؟
استدعِ  بنفس  +  — تُحدَّث الذاكرة
الموجودة، لا تُكرّر.
[CODE BLOCK]
كيف أحذف ذاكرة؟
[CODE BLOCK]
هل أستطيع الحذف الكمي؟
نعم:
[CODE BLOCK]
الخطوات التالية
- نظرة عامة على الـ API
- الأخطاء ومعالجتها
- المصادقة