# HTTP-запросы

### Работа с HTTP-запросами

Это руководство поможет вам научиться создавать HTTP-запросы, редактировать их и использовать в сценариях на платформе.

<div id="bkmrk--1">---

</div>### **1. Работа с HTTP-запросами**

#### **1.1. Просмотр списка запросов**

[![image.png](https://docs.platform-vision.is74.ru/uploads/images/gallery/2025-05/scaled-1680-/image.png)](https://docs.platform-vision.is74.ru/uploads/images/gallery/2025-05/image.png)

1. Перейдите в раздел **"HTTP-запросы"**.
2. На странице отображается список всех существующих запросов:
    
    
    - Поле поиска позволяет найти запрос по названию.
    - Фильтры помогут выбрать запросы, связанные с определёнными сценариями.
3. Чтобы создать новый запрос, нажмите кнопку **"Создать HTTP-запрос"**.

#### **1.2. Создание HTTP-запроса**

[![image.png](https://docs.platform-vision.is74.ru/uploads/images/gallery/2025-05/scaled-1680-/JDnimage.png)](https://docs.platform-vision.is74.ru/uploads/images/gallery/2025-05/JDnimage.png)

1. После нажатия кнопки **"Создать HTTP-запрос"** откроется редактор.
2. В разделе **"Основные данные"**:
    
    
    - Укажите название запроса.
    - Выберите тип запроса (например, GET или POST).
    - Вставьте URL-адрес для отправки запроса.
    - После заполнения основных данных вопрос можно сохранять, но лучше не делайте этого до получения результатов, совпадающих с настроенными принимаемыми результатами, чтобы избежать ошибок в реальных звонках при использовании запроса в сценариях.
3. В разделе **"Входные параметры"**:
    
    
    - На вкладке **"Параметры"** добавьте ключи и значения параметров.
    - На вкладке **"Заголовки"** укажите заголовки запроса.
    - На вкладке **"Тело"** укажите структуру тела запроса, если это POST-запрос.
    - Обратите внимание, что если мы передаем либо в сам ключ, либо в значение название в «{{}}», то этот параметр будет передаваться из самого сценария в виде переменной. И он отобразится в поле «Переменные во входных параметрах»  
         [![image.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2025-01/scaled-1680-/AtPimage.png)](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2025-01/AtPimage.png)
4. В разделе **"Принимаемые результаты"**:
    
    
    - Добавьте параметры, которые сервер возвращает в ответе.
    - Укажите вложенные параметры (до 5 уровней вложенности).
    - После добавления параметров нажмите **"Сохранить запрос"**. Затем перейдите в раздел **"Результаты"**, чтобы протестировать запрос.
        
        [![image.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2025-01/scaled-1680-/vnuimage.png)](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2025-01/vnuimage.png)

#### **1.3. Работа с разделом "Результаты"**

1. После настройки нажмите кнопку **"Получить результаты"**.
2. Запрос отправится, и вы увидите статус выполнения (например, 200 OK), а также время обработки запроса.
3. Сравните возвращённые результаты с указанными принимаемыми параметрами: совпадения подсвечиваются зелёным цветом, а несоответствия красным. Вы можете редактировать или удалять принимаемые параметры в этом разделе, чтобы уточнить настройки.

[![image.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2025-01/scaled-1680-/Cz2image.png)](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2025-01/Cz2image.png)

### **1.4. Сохранение запроса**

1. Сохраняйте запрос только после того, как убедитесь, что принимаемые результаты совпадают с полученными в разделе "Результаты".
2. Если результаты не совпадают, скорректируйте принимаемые параметры или настройте запрос повторно, чтобы избежать ошибок в реальных звонках.

[![image.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2025-01/scaled-1680-/dWfimage.png)](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2025-01/dWfimage.png)