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

HTTP-запросы

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

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

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

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

Вimage.png

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

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

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

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

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

    "Создать

    1. Далее нужно HTTP-запролнитьс".

    необходимые
    4. поля
для

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

image.png

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

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

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

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

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

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

  3. В разделе "Входные параметры":

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

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

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

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

  4. В разделе "Принимаемые результаты":

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

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

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

      image.png

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

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

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

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

 

image.png

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

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

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

image.png

2. Использование HTTP-запросов в сценариях

image.png

2.1. Добавление блока "Отправить HTTP-запрос"

  1. Перейдите в редактор сценариев.

  2. Щелкните правой кнопкой мыши по рабочему пространству и выберите "Отправить HTTP-запрос".

2.2. Настройка блока

  1. Выберите ранее созданный запрос. При этом, если уз выпадающего списка.

  2. Нас исптрользуюйтсяе входные параметры:

    (2.1)

    • Для каждого параметра выберите переменную сценария, которая будет передавать значение.

  3. Настройте при тестировании,маемые результаты:

    • Для каждого вы озвращаеможете задать имго значения в ыберазделе «Входные параметры» (2.1)
      4. После тестирования запроса, нажмите на кнопку save_http 

      image.png

      Блок HTTP-запрос

      Теперьеменную, когторая будет использова нужный запрос к API добавлен, вернемться в сценаредактор и добавим блок «HTTP-запрос».

      №

      Действие

      Скрин

      1

      Нажмите ПКМ по полотну и в появившемся списке выберите блок «Отправить HTTP-запрос»

      image.png

      2

      В выпадающем списке выбираем наш созданный запрос

      image.png

      3

      После выбора запроса в разделе «Входные параметры» как раз-таки появляется параметр, который мы добавляли

      image.png

      4

      Присваиваем ему переменную сценария «agent_id» (как создать переменную в сценарии читай тут)


      Таким образом, мы передаем значение переменной из сценария в значение ключа нашего HTTP-запроса

      image.png

      5

      Нажимаем на вкладку «Результаты запроса» и видим, что наш запрос возвращает значение «doctor_call» 


      Теперь также выбираем/создаем переменную из сценария, которой мы присвоим возвращаемое http-запросом значение

      image.png

      6

      Сохраняем блок

       

      image.png

       

2.3. Проверка и сохранение

  1. Убедитесь, что все входные параметры и результаты настроены корректно.

  2. Сохраните изменения сценария.

3. Советы и рекомендации

  • Тестируйте запросы отдельно в редакторе запросов перед сохранением и перед добавлением в сценарий: это поможет избежать ошибок при настройке сценария.

  • Следите за вложенностью: Максимальная глубина вложенности принимаемых параметров — 5 уровней.

  • Используйте понятные названия переменных в редакторе сценариев: Это упростит их использование в сценариях.

Примечание

Для дополнительной информации по настройке блоков сценариев ознакомьтесь с разделом "Редактор сценариев" в документации.

Наверх