> For the complete documentation index, see [llms.txt](https://docs.intellectdialog.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.intellectdialog.com/integration.intellectdialog/blok-zapusk-api.md).

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

<figure><img src="https://1141222632-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvdtSkqUDuO5XM96AcLMV%2Fuploads%2FR5u9aBHBDBCe6vxgU19c%2Fimage.png?alt=media&amp;token=1ad7ff3f-9773-46e0-9661-1add3c57943e" 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="https://1141222632-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvdtSkqUDuO5XM96AcLMV%2Fuploads%2Fsy2oEmn62hBGRtoNo2bH%2Fimage.png?alt=media&amp;token=609946d3-2a38-4067-adbc-41df22e5876a" alt=""><figcaption></figcaption></figure>

  <figure><img src="https://1141222632-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvdtSkqUDuO5XM96AcLMV%2Fuploads%2FDW7jUo1Au4yElaO3u7zD%2Fimage.png?alt=media&amp;token=8aef4774-c51e-454a-9439-44b1603b3383" alt=""><figcaption></figcaption></figure>

  <figure><img src="https://1141222632-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvdtSkqUDuO5XM96AcLMV%2Fuploads%2FyBZSTzHp1hXQdbNvRYX9%2Fimage.png?alt=media&amp;token=571aacbc-4542-4b57-8b04-7da94e07eccf" alt=""><figcaption></figcaption></figure>