# Кастомный запрос

## Введение

Когда в процессе нужно вызвать внешний интерфейс или сторонний сервис, это можно сделать через Custom request — кастомный HTTP-запрос. Типичные сценарии использования:

* Вызов API внешних систем (CRM, AI-сервисы и т. п.)
* Получение удалённых данных и их обработка в последующих шагах процесса
* Передача данных в стороннюю систему (Webhook, уведомления и т. п.)
* Запуск автоматических процессов во внутренних или внешних сервисах

![](https://static-docs.nocobase.com/Custom-request-03-27-2026_06_07_PM.png)


## Конфигурация действия

![](https://static-docs.nocobase.com/Custom-request-03-27-2026_06_09_PM.png)

В разделе «Настройки кнопки» → «Кастомный запрос» доступны следующие параметры:

* HTTP method — метод HTTP-запроса, например GET, POST, PUT, DELETE.
* URL — целевой адрес запроса. Можно указать полный URL интерфейса или динамически собрать его через переменные.
* Headers — заголовки запроса, используются для передачи аутентификационной информации или служебных параметров, например Authorization, Content-Type и т. п.
* Parameters — параметры строки запроса (Query Parameters), обычно применяются для GET-запросов.
* Body — тело запроса; обычно применяется для POST, PUT и подобных запросов, может содержать JSON, данные формы и т. п.
* Timeout config — настройка таймаута запроса, ограничивает максимальное время ожидания и предотвращает длительную блокировку процесса.
* Response type — тип данных, ожидаемых в ответе.
* JSON — интерфейс возвращает JSON; результат записывается в контекст процесса и доступен в последующих шагах через `ctx.steps`.
* Stream — интерфейс возвращает поток данных (Stream); после успешного запроса автоматически запускается скачивание файла.
* Access control — управление доступом, ограничивает, каким ролям разрешено запускать этот шаг, чтобы обеспечить безопасность вызова интерфейса.

## Прочие параметры действия

Помимо настроек запроса, кнопка кастомного запроса поддерживает и другие распространённые параметры:

- [Редактировать кнопку](/interface-builder/actions/action-settings/edit-button) — настройка заголовка, стиля, иконки и т. п.;
- [Правила связывания действий](/interface-builder/actions/action-settings/linkage-rule) — динамическое управление видимостью, доступностью и другими состояниями кнопки в зависимости от условий;
- [Двойное подтверждение](/interface-builder/actions/action-settings/double-check) — после нажатия сначала появляется диалог подтверждения, и только затем фактически отправляется запрос;
