Вызов API модуля
platform.api_call
Вызывает зарегистрированный REST-роут модуля платформы (метод+путь) под JWT/RLS текущего принципала. Доступны только зарегистрированные роуты; произвольные URL и внешние хосты запрещены. Право наследуется от целевого роута (энфорс на gateway). Вход: module, method, path, query, body; выход: status, body.
Входы
| Ключ | Тип | Описание |
|---|---|---|
| module* | string | Модуль |
| method* | string | Метод |
| path* | string | Путь |
| query | object | Параметры запроса |
| body | any | Тело запроса |
Выходы
| Ключ | Тип | Описание |
|---|---|---|
| status | number | HTTP-статус |
| body | any | Тело ответа |
| success | boolean | Успех |
Что делает
Нода вызывает зарегистрированный REST-роут модуля платформы — по префиксу модуля, HTTP-методу и относительному пути. Это универсальный способ обратиться к возможностям модуля из автоматизации, когда для операции нет отдельной специализированной ноды.
Вызов идёт под правами текущего пользователя: запрос проходит через шлюз платформы с полным стеком безопасности — проверкой доступа и изоляцией данных по тенанту. Требуемое право не задаётся на ноде, а наследуется от целевого роута и проверяется шлюзом. Обратиться можно только к зарегистрированным роутам модулей — произвольные URL и внешние хосты запрещены.
Когда применять
Сценарий «последней мили» в автоматизации без AI-агента: например, залить распарсенную банковскую выписку в финансовый модуль вызовом соответствующего роута импорта — без отдельной типизированной ноды. У AI-агента та же возможность доступна как универсальный инструмент, поэтому поведение сценария и агента согласовано. Важно: нода умеет вызывать и изменяющие данные роуты (POST/PUT/PATCH/DELETE) — такие действия из AI-агента требуют подтверждения пользователя.
Что на входе и в ответе
На входе — модуль, метод, относительный путь, параметры строки запроса и тело запроса. В ответе — HTTP-статус, тело ответа (разобранный JSON или строка) и признак успеха (статус в диапазоне 2xx).