Действие HTTP-запроса для Workflows

Материал из Документация Ключ-АСТРОМ

Действие HTTP-запроса для Workflows

Действие HTTP-запроса для Workflows позволяет отправлять HTTP-запрос к любому API.

Безопасность действия HTTP-запроса

Все HTTP-вызовы проверяются по глобальному списку разрешённых. Мы настоятельно не рекомендуем указывать статический заголовок Authorization и тем самым раскрывать секрет. Используйте хранилище учётных данных для хранения учётных данных для базовой аутентификации или аутентификации по токену, либо действие «Запустить JavaScript» для реализации любой другой аутентификации.

Входные данные

  • Метод: метод HTTP-запроса.
  • URL: URL, на который должен быть направлен запрос.
  • Аутентификация: действие HTTP-запроса поддерживает использование учётных данных из хранилища учётных данных для базовой аутентификации и аутентификации по токену. Убедитесь, что конфигурация учётных данных разрешает доступ для актора Workflow (область действия учётных данных: AppEngine, доступ к приложению: приложение Workflows, доступ владельца или актор в качестве выбранного пользователя).
  • Полезная нагрузка: полезная нагрузка HTTP-запроса. Установите соответствующий заголовок content-type.
  • Заголовки: заголовки HTTP-запроса с их именами и значениями. Имейте в виду, что любое значение заголовка доступно в мониторе Workflow всем, у кого есть доступ к Workflow. Мы настоятельно не рекомендуем раскрывать какие-либо секреты, а вместо этого использовать конфигурацию аутентификации через хранилище учётных данных.
  • Обработка ошибок: коды ответов HTTP, которые приводят к сбою задачи. В зависимости от варианта использования отправка HTTP-запроса независимо от ответа должна быть успешной. Поэтому отключите опцию сбоя при определённых кодах ответа HTTP или определите коды ответа HTTP, которые должны привести к сбою задачи.

Результат

Результат действия HTTP-запроса — это структура JSON, которая включает:

  • status_code: код состояния HTTP-ответа.
  • body: необработанное тело HTTP-ответа.
  • headers: заголовки HTTP-ответа в виде объектов, состоящих из имени и значения заголовка.
  • json: HTTP-ответ в виде документа JSON. Поддерживаются только полезные нагрузки ответа JSON.