Интерактивный 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). Их можно просмотреть и вызвать прямо в браузере; схема генерируется из кода сервера.

Базы у двух групп разные, и спека называет их в поле 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. См. Аутентификация:

bash
curl https://samreshuuu.ru/v1/models \ -H "Authorization: Bearer $SAMRESHUUU_API_KEY"

Запросы из эксплорера идут в боевой API с вашим ключом: ход агента тратит квоту тарифа, вызов коннектора обращается к настоящему сервису. Отсутствующий или неверный ключ возвращает 401, ключ без нужного права получает 403 AUTH_PERMISSION_DENIED. Остальные отказы описаны в разделе Ошибки и лимиты API агентов.

Сгенерировать клиент

Спека в стандартном формате OpenAPI 3, передайте её любому генератору, чтобы получить типизированный клиент.

bash
npx @openapitools/openapi-generator-cli generate \ -i https://samreshuuu.ru/api/v1/developers/openapi.json \ -g typescript-fetch \ -o ./samreshuuu-client

Та же спека работает с любым 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 агентов».

Была ли страница полезна?