# API FAQ
SUMMARY: Поширені питання про API — автентифікація, обмеження частоти, обробка помилок, виявлення кінцевих точок.

API FAQ
Поширені запитання щодо API Synapse.
Як автентифікуватися?
Два методи:
1. Mind Key (для кінцевих точок даних): 
2. JWT (для кінцевих точок облікового запису): 
Або через параметр запиту (ліміт 60 запитів/хв): 
Дивіться Автентифікацію.
У чому різниця між Mind Key та JWT?
- Mind Key: прив'язаний до mind-у, ніколи не закінчується, для даних memory/chat/tasks
- JWT: прив'язаний до користувача, термін дії 7 днів, для керування обліковим записом/mind-ами
Дивіться 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-only інструментів:
-  ↔ 
-  ↔ 
-  ↔ 
Перевірте  для доступних 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 та Семантичний пошук.
Як оновити спогад?
POST  з тією ж  +  — наявний спогад оновлюється, а не
дублюється.
[CODE BLOCK]
Як видалити спогад?
[CODE BLOCK]
Чи можна масово видаляти?
Так:
[CODE BLOCK]
Наступні кроки
- Огляд API
- Помилки та обробка помилок
- Автентифікація