Перейти к основному контенту

HTTP-запросы

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

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


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

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

image.png

  1. Перейдите в раздел "HTTP-запросы".

  2. На странице отображается список всех существующих запросов:

    • Поле поиска позволяет найти запрос по названию.

    • Фильтры помогут выбрать запросы, связанные с определёнными сценариями.

  3. Чтобы создать новый запрос, нажмите кнопку "Создать HTTP-запрос".

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

image.png


  1. После нажатия кнопки "Создать HTTP-запрос" откроется редактор.

  2. В разделе "Основные данные":

    • Укажите название запроса.

    • Выберите тип запроса (например, GET или POST).

    • Вставьте URL-адрес для отправки запроса.

    • После заполнения основных данных вопрос можно сохранять, но лучше не делайте этого до получения результатов, совпадающих с настроенными принимаемыми результатами, чтобы избежать ошибок в реальных звонках при использовании запроса в сценариях.
  3. В разделе "Входные параметры":

    • На вкладке "Параметры" добавьте ключи и значения параметров.

    • На вкладке "Заголовки" укажите заголовки запроса.

    • На вкладке "Тело" укажите структуру тела запроса, если это POST-запрос.

    • Обратите внимание, что если мы передаем либо в сам ключ, либо в значение название в «{{}}», то этот параметр будет передаваться из самого сценария в виде переменной. И он отобразится в поле «Переменные во входных параметрах»
       image.png
  4. В разделе "Принимаемые результаты":

    • Добавьте параметры, которые сервер возвращает в ответе.

    • Укажите вложенные параметры (до 5 уровней вложенности).

    • После добавления параметров нажмите "Сохранить запрос". Затем перейдите в раздел "Результаты", чтобы протестировать запрос.

      image.png

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

  1. После настройки нажмите кнопку "Получить результаты".

  2. Запрос отправится, и вы увидите статус выполнения (например, 200 OK), а также время обработки запроса.

  3. Сравните возвращённые результаты с указанными принимаемыми параметрами: совпадения подсвечиваются зелёным цветом, а несоответствия красным. Вы можете редактировать или удалять принимаемые параметры в этом разделе, чтобы уточнить настройки.

image.png

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

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

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

image.png