# FAQ по API
SUMMARY: Типовые вопросы по API — аутентификация, лимиты, обработка ошибок, обнаружение эндпоинтов.

FAQ по API
Типовые вопросы по Synapse API.
Как аутентифицироваться?
Два способа:
1. Mind Key (для данных): 
2. JWT (для аккаунтов): 
Или через query-параметр (лимит 60 запросов/мин): 
См. Аутентификация.
В чём разница между Mind Key и JWT?
- Mind Key: область — арендатор, не истекает, для данных памяти/чата/задач
- 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?
Вы используете аутентификацию через query-параметр , лимит — 60 запросов/мин.
Решение: Перейдите на заголовок  (без лимита).
См. Лимиты запросов.
Как получить список всех эндпоинтов?
[CODE BLOCK]
Как найти нужный эндпоинт?
1. Проверьте  для машиночитаемого списка
2. Проверьте  для полной документации API
3. Просмотрите  — систему документации
4. Используйте  для спецификации OpenAPI 3.0
Можно ли использовать GET вместо POST?
У некоторых POST-эндпоинтов есть GET-эквиваленты для инструментов, работающих только с URL:
-  ↔ 
-  ↔ 
-  ↔ 
Проверьте  на наличие GET-вариантов.
Как обрабатывать ошибки?
Все ошибки возвращают JSON:
[CODE BLOCK]
См. Ошибки и обработка ошибок.
Какой лимит размера тела запроса?
10 МБ. Для больших payloads (например, загрузка файлов) используйте 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
- Ошибки и обработка ошибок
- Аутентификация