voximplant KitDocs
  1. Управление
  2. Автоматизация
  3. Редактор сценариев
  4. Блоки сценариев
  5. HTTP-запрос
Rate this page:

HTTP-запрос

Используйте этот блок для создания http-запросов к внешнему сервису. В зависимости от выбранного метода вы можете либо получать данные от сервиса, либо отправлять их на него.

  • GET — Отправляет данные от запрашиваемого ресурса. Запросы этого метода могут только извлекать данные. Можно использовать, например, для заполнения переменных.

  • POST — Отправляет данные на ресурс.

  • HEAD — Предоставляет ответ от запрашиваемого ресурса.

  • DELETE — Позволяет удалить указанный ресурс.

  • PUT — Позволяет заменить представление ресурса данными из запроса.

  • PATCH — Частично изменяет ресурс.

Чтобы создать http-запрос, выполните следующие действия:

  1. Подключите блок, используя порт Успешно.
  2. Дважды щелкните блок HTTP-запрос.
HTTP-запрос
  1. В разделе Основные настройки:

  • Выберите нужный метод из раскрывающегося списка.

  • Введите URL-адрес службы в поле URL:port.

  • Включите настройку Проигрывать аудио, чтобы активировать воспроизведение звука. Выберите аудиофайл из раскрывающегося списка Аудиозаписи. Нажмите Загрузить, чтобы загрузить аудиофайл с вашего компьютера.

  1. В разделе Заголовок укажите заголовки ответа, необходимые для запроса услуги:

  • Нажмите Добавить заголовок.

  • Выберите нужный заголовок из раскрывающегося списка Заголовок.

  • Введите переменную в поле Значение.

  1. В разделе Параметры запроса настройте параметры запроса:

  • Введите необходимый параметр в поле Параметр.

  • Введите переменную в поле Значение.

  1. В разделе Сопоставление переменных настройте параметры ответа. Нажмите Добавить ответ и выберите один из следующих параметров:

  • Использовать данные из HTTP ответа — Ответ на основе HTTP-запроса. Нажмите Получить данные, чтобы настроить данные ответа на основе данных сценария.

  • Использовать пример данных из JSON — Ответ основан на JSON. Введите данные в поле данных JSON и нажмите Анализ данных.

  • Укажите путь к данным вручную — Введите или выберите переменную из раскрывающегося списка Переменная, введите путь в поле Путь. Если для указанной переменной нет данных, установите значение в поле Если путь не существует.

Сопоставление переменных
  1. Нажмите Сохранить или Сохранить как шаблон, если необходимо.

Использование данных HTTP ответа

Copy URL
  1. В разделе Сопоставление переменных нажмите Добавить ответ и выберите Использовать данные из HTTP ответа из раскрывающегося списка.
  2. В окне Предварительный запрос нажмите Получить данные.
Примечание

Если вы ввели переменные в блок HTTP-запрос, для отправки запроса необходимо будет ввести данные из переменных.

  1. В окне Ответ сервера установите флажки рядом с нужными полями.

Данные из этих полей будут записываться в переменные.

  1. Нажмите Получить переменные.

Использование примеров данных из JSON

Copy URL

Используйте любую платформу API, чтобы получить требуемый ответ сервера и записать его в файл JSON.

  1. В разделе Сопоставление переменных нажмите Добавить ответ и выберите Использовать пример данных из JSON в раскрывающемся списке.
  2. Введите ранее сгенерированный ответ сервера и нажмите Получить данные.
  3. В окне Ответ сервера установите флажки рядом с нужными полями.

Данные из этих полей будут записываться в переменные.

Ввод данных вручную

Copy URL
  1. В разделе Сопоставление переменных нажмите Добавить ответ и выберите Укажите путь к данным вручную в раскрывающемся списке.
  2. Выберите имя переменной из раскрывающегося списка. Если переменная не найдена, введите нужное имя и нажмите Enter.
  3. Введите путь к переменной и ее значение.
Важно

Разделяйте каждое значение объекта косой чертой.

  1. Нажмите Сохранить.
Примечание

Разные сервисы и серверы используют свои методы, запросы лучше формировать в соответствии с ними.