# Обзор API и базовый URL
SUMMARY: Все эндпоинты Synapse API, базовый URL, паттерны аутентификации и форматы ответов — кратко в одном месте.

KEY CONTEXT:
Base URL: https://synapse.schaefer.zone
Auth: Authorization: Bearer YOUR_MIND_KEY (header, no rate limit)
      OR ?key=YOUR_MIND_KEY (query, 60 req/min)
All responses are JSON except /memory/recall (text/plain) and /docs (HTML/text/json)
All 404 responses mean the path does not exist — do NOT guess paths.
GET /endpoints returns machine-readable list of all valid endpoints.

Обзор API и базовый URL
Synapse API — это RESTful HTTP API. Все эндпоинты возвращают JSON (кроме
отмеченных случаев). На этой странице описано всё необходимое перед переходом
к конкретным эндпоинтам.
Базовый URL
[CODE BLOCK]
Все пути в этой документации указаны относительно этого базового URL. Для
self-hosted экземпляров замените на ваш собственный URL.
Аутентификация
Два способа, оба передаются через заголовок :
[CODE BLOCK]
Или через query-параметр (с лимитом 60 запросов в минуту):
[CODE BLOCK]
Подробнее см. Аутентификация.
Группы эндпоинтов
| Группа | Аутентификация | Описание |
|-------|------|-------------|
| Public | Нет | Главная страница, health, OpenAPI, документация |
| Memory | Mind Key | CRUD, поиск, синхронизация, эмбеддинги |
| Chat | Mind Key / JWT | Асинхронные сообщения между человеком и агентом |
| Tasks | Mind Key | Управление задачами |
| Scripts | Mind Key / JWT | Постоянное хранилище скриптов |
| Scheduler | Mind Key | Cron-задачи + переменные |
| Webhooks | Mind Key | HTTP-колбэки на события |
| Computers | Mind Key / JWT | Удалённое управление компьютерами |
| User/Minds | JWT | Аккаунт + управление mind |
| Sharing | JWT | Совместное использование mind между пользователями |
| Push | JWT | Web Push-подписки |
| Tools | Нет | Время, калькулятор, случайные числа (публичные утилиты) |
Форматы ответов
- JSON (по умолчанию): 
- Простой текст:  возвращает текст, оптимизированный для LLM
- HTML: , , , , 
Стандартная обёртка ответа
Успешные ответы возвращают данные напрямую:
[CODE BLOCK]
Ответы с ошибкой используют следующий формат:
[CODE BLOCK]
> [!NOTE]
> Поле  содержит ссылку на соответствующую документацию для типичных ошибок.
HTTP-коды состояния
| Код | Значение |
|------|---------|
| 200 | Успех (GET, PUT) |
| 201 | Создано (POST) |
| 204 | Нет содержимого (DELETE) |
| 400 | Некорректный запрос (ошибка валидации) |
| 401 | Не авторизован (отсутствует/неверный токен) |
| 403 | Доступ запрещён (неверный тип токена) |
| 404 | Не найдено (путь не существует) |
| 409 | Конфликт (дубликат) |
| 429 | Слишком много запросов (лимит) |
| 500 | Ошибка сервера |
Эндпоинты обнаружения
| Эндпоинт | Назначение |
|----------|---------|
|  | Главная страница (оптимизирована для LLM) |
|  | Машиночитаемый список всех эндпоинтов |
|  | Список эндпоинтов простым текстом |
|  | Спецификация OpenAPI 3.0 |
|  | Полная документация API (HTML) |
|  | Документация API в JSON |
|  | Система документации (HTML) |
|  | Индекс документации (JSON) |
|  | Вся документация одним текстовым блоком |
|  | Интерактивная песочница API |
Лимиты запросов
| Способ аутентификации | Лимит |
|-------------|-------|
| Mind Key (заголовок) | Нет |
| Mind Key (?key=) | 60/мин на IP |
| JWT (заголовок) | Нет |
| Публичные эндпоинты | Нет |
Ответы с лимитом включают:
[CODE BLOCK]
Пагинация
Списочные эндпоинты поддерживают  и :
[CODE BLOCK]
Лимит по умолчанию: 100. Максимальный лимит: 500.
CORS
Все эндпоинты поддерживают CORS для браузерных клиентов:
[CODE BLOCK]
SDK и клиенты
- Node.js SDK:  (репозиторий)
- MCP-сервер:  (репозиторий)
- HTTP-клиент: любая HTTP-библиотека (curl, fetch, axios и т. д.)
Следующие шаги
- Memory API — самые важные эндпоинты
- Chat API — асинхронное общение человека и агента
- Ошибки и обработка ошибок