Интерактивный API-эксплорер
Публичная схема ключа агента содержит 7 операций: API агентов (POST /v1/chat/completions, GET /v1/models) и коннекторы по ключу (GET /v1/connectors, GET /v1/connectors/{service}, POST /v1/connectors/{service}/execute, GET /v1/connectors/approvals/{approval_id}, GET /v1/connections). Их можно просмотреть и вызвать прямо в браузере; схема генерируется из кода сервера.
- Эксплорер:
samreshuuu.ru/api/v1/developers/docs - OpenAPI-спека:
samreshuuu.ru/api/v1/developers/openapi.json
Базы у двух групп разные, и спека называет их в поле servers: операции API агентов идут на https://samreshuuu.ru/v1, операции коннекторов на https://api.samreshuuu.ru/v1. Пути /v1/models и /v1/chat/completions на api.samreshuuu.ru принадлежат API моделей, который в эту спеку не входит.
Авторизация
Каждая операция принимает ключ агента (sk-org-…) и называет нужное право в своём security: API агентов просит chat:write, операции коннекторов просят tools:read, а вызов коннектора на запись проверяет tools:write по самому вызову. На токен вошедшего пользователя операция отвечает 401 AUTH_TOKEN_INVALID. См. Аутентификация:
Запросы из эксплорера идут в боевой API с вашим ключом: ход агента тратит квоту тарифа, вызов коннектора обращается к настоящему сервису. Отсутствующий или неверный ключ возвращает 401, ключ без нужного права получает 403 AUTH_PERMISSION_DENIED. Остальные отказы описаны в разделе Ошибки и лимиты API агентов.
Сгенерировать клиент
Спека в стандартном формате OpenAPI 3, передайте её любому генератору, чтобы получить типизированный клиент.
Та же спека работает с любым OpenAPI-совместимым тулчейном: поменяйте цель -g на python, go, java и так далее, либо направьте инструменты вроде openapi-typescript прямо на URL.
Что входит в публичную поверхность
Спека охватывает API агентов и коннекторы по ключу. Выполнение кода через REST не доступно: обращайтесь к нему через агента в чате или инструментом repl_execute MCP-сервера. Нативный /api/v1 приложений Сам Решу в публичную поверхность не входит.
Лимиты
Все операции спеки тратят минутный лимит ключа по тарифу; таблица лимитов, ключ без тарифа и повторные попытки описаны в разделе Ошибки и лимиты API агентов.
Частые вопросы
Что охватывает интерактивный API-эксплорер?
Операции ключа агента: API агентов (POST /v1/chat/completions, GET /v1/models) и коннекторы по ключу (GET /v1/connectors, GET /v1/connectors/{service}, POST /v1/connectors/{service}/execute, GET /v1/connectors/approvals/{approval_id}, GET /v1/connections). Их можно просмотреть и вызвать в браузере; спека генерируется из кода сервера. API моделей в эту спеку не входит, выполнение кода доступно только через MCP.
Как авторизовать запрос?
Передайте ключ агента в Authorization: Bearer sk-org-... Каждая операция в спеке называет право, нужное ключу: API агентов требует chat:write, каталог, паспорт, список подключений, статус согласия и чтение коннекторов требуют tools:read, вызов коннектора на запись требует tools:write. Ключ без нужного права получает 403 AUTH_PERMISSION_DENIED.
Можно ли сгенерировать типизированный клиент из API?
Да. Спека по адресу /api/v1/developers/openapi.json в стандартном формате OpenAPI 3, передайте её любому генератору (openapi-generator, openapi-typescript и другим), чтобы получить типизированный клиент на вашем языке.
Есть ли лимиты на API?
Да. Минутный лимит каждого ключа зависит от тарифа организации, и все операции спеки тратят один бюджет. При известной задержке отказ содержит Retry-After. Таблица лимитов и полный контракт описаны в разделе «Ошибки и лимиты API агентов».