# Блок: Запуск API

<figure><img src="/files/0XYMPeXSyjUNdkovog6k" alt=""><figcaption></figcaption></figure>

* Блок **"Запуск API сценария"** используется для вызова заранее настроенного сценария API, который прописан в блоке "API запуск". Это позволяет выполнять интеграцию с внешними сервисами в нужный момент сценария.

  ####
* #### **Особенности работы блока**
  1. **Связь с блоком "API запуск":**
     * Все API-запросы и интеграции настраиваются в блоке "API запуск".
     * Блок "Запуск API сценария" лишь вызывает конкретный сценарий, прописанный в "API запуск".
  2. **Динамическое выполнение сценария:**
     * Этот блок может быть вызван на любом этапе логики сценария в зависимости от условий.
     * Выполняет запуск API-запросов в момент, когда требуется передать данные или получить ответ от внешнего сервиса.
  3. **Гибкость использования:**
     * Позволяет повторно использовать один и тот же API-сценарий в разных частях логики, исключая дублирование настроек.

### Примеры использования

* **Пример варианта №1**

  #### Пример структурированной логики работы сценария

  **Этап 1: Подключение JSON-документа**

  * В блоке **API-запрос** подключён JSON-документ, содержащий данные (например, список автомобилей).
  * Указан **URL** для получения данных и настроен запрос типа `GET` с типом контента `application/json`.

  **Этап 2: Запрос параметров в стартовом блоке**

  * В стартовом блоке "Старт" определены параметры, необходимые для формирования выборки:
    * `model` — Модель автомобиля.
    * `minPrice` — Минимальная цена.
    * `maxPrice` — Максимальная цена.
    * `color` — Цвет автомобиля.
    * `minYear` — Год выпуска.
  * Эти параметры запрашиваются у пользователя на начальном этапе сценария.

  **Этап 3: Проверка введённых параметров**

  * В блоке **Проверка параметров**:
    * Проверяется, предоставил ли пользователь все обязательные параметры.
    * Если какой-либо параметр отсутствует, блок запрашивает его у пользователя.

  **Этап 4: Проверка условий**

  * В блоке **Проверка условий**:
    * Уточняется, соответствуют ли параметры запросу (например, проверка на наличие автомобилей в заданной локации или подходящих по критериям).

  **Этап 5: Запуск API сценария**

  * После проверки всех условий запускается блок **Запуск API сценария**, связанный с подключённым JSON-документом.

  <figure><img src="/files/4OJ8hOKjG8WcDQ0uAkpR" alt=""><figcaption></figcaption></figure>

  <figure><img src="/files/iLABu9fSqeVy6tqRbQBK" alt=""><figcaption></figcaption></figure>

  <figure><img src="/files/Sbo1iN1m7UPWk0XHmNQe" alt=""><figcaption></figcaption></figure>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.intellectdialog.com/integration.intellectdialog/blok-zapusk-api.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.