История страницы
...
Группа действий: Интеграции
...
Отправляет Действие отправляет HTTP-запрос для обращения к RESTful веб-сервису
Настройки
Свойство | Описание | Тип | Пример заполнения | Обязательность заполнения поля | ||||||||||||||||||
Параметры | ||||||||||||||||||||||
URL REST-сервиса | URL REST-сервиса | Robin.String | Да | |||||||||||||||||||
Метод | Определяет тип создаваемого запроса. По умолчанию Get. | Robin.String | Нет | |||||||||||||||||||
Тело запроса | Тело отправляемого запроса. Позволяет отправить запрос в виде JSON строки. | Robin.String | Нет | |||||||||||||||||||
Параметры запроса | Параметры строки запроса | Robin.Dictionary | Нет | |||||||||||||||||||
Параметры формы | Параметры HTML формы для метода POST. | Robin.Dictionary | Нет | |||||||||||||||||||
Авторизация | Словарь с параметрами авторизации - Basic или Bearer Token. В случае Basic авторизации словарь должен иметь ключи «user» и «pass», а значения элементов словаря должны содержать логин и пароль пользователя. В случае Bearer Token авторизации словарь должен иметь ключ «token», а значение элемента должно содержать Bearer Token. | Robin.Dictionary | Нет | |||||||||||||||||||
Заголовки запроса | Набор заголовков отправляемого запроса и их значений. Каждый ключ – отдельный заголовок. | Robin.Dictionary | Нет | |||||||||||||||||||
Путь к файлу для отправки методом POST | Путь к файлу, который нужно прикрепить к запросу. | Robin.FilePath | Нет | |||||||||||||||||||
Выбор прокси-сервера | Выпадающий список из элементов: "Системный прокси-сервер", "Без Определяет настройки используемого прокси-сервера | ", "Пользовательский прокси-сервер". | Значение по умолчанию - "Системный прокси-сервер". Описание: "Можно использовать системные настройки прокси, заданные на уровне ОС, либо настроить параметры пользовательского прокси-сервера, либо подключаться без прокси-сервера. По умолчанию используются системные настройки. | Robin.String | Нет | |||||||||||||||||
Протокол прокси- сервера | Протокол прокси-сервера. Например: http, https | Robin.String | Нет | |||||||||||||||||||
Имя хоста или IP-адрес прокси-сервера | Имя хоста или IP-адрес прокси-сервера | Robin.String | Нет | |||||||||||||||||||
Порт прокси-сервера | Порт прокси-сервера | Robin.String | Нет | |||||||||||||||||||
Логин пользователя для подключения к прокси- серверу | Логин пользователя для подключения к прокси-серверу | Robin.String | Нет | |||||||||||||||||||
Пароль пользователя для подключения к прокси-серверу | Пароль пользователя для подключения к прокси-серверу | Robin.Object | Нет | Да|||||||||||||||||||
Получить файл | Возможность получить файлы из запроса. Если выбрано значение | "true"«true», обязательно должны быть заполнены поля | "Путь «Путь до | папки" и "Имя файла"папки» и «Имя файла». | Robin.Boolean | true | Нет | |||||||||||||||
Путь до папки | Путь к папке, в которой нужно сохранить полученный файл. | Robin.FolderPath | C:\doc\img | Нет | ||||||||||||||||||
Имя файла | Поле для имени файла с расширением | , чтобы сразу сохранять его в должном виде. | Robin.String | Нет | ||||||||||||||||||
Перезаписать | Перезаписать существующий файл. В случае, если значение параметра false, а в указанной папке уже существует файл с таким же именем и расширением, то будет вызвана ошибка. Значение по умолчанию - false. | Robin.Boolean | true | Нет | Протокол прокси- сервера | |||||||||||||||||
Отключить SSL | Отключить SSL. Если значение true, то отключается опция проверки SSL-сертификата. По умолчанию значение false. | Robin.Boolean | true | Протокол прокси-сервера. Например: http, https | Robin.String | Нет | Имя хоста или IP-адрес прокси-сервера | Имя хоста или IP-адрес прокси-сервера | Robin.String | Нет | Порт прокси-сервера | Порт прокси-сервера | Robin.String | Нет | Логин пользователя для подключения к прокси- серверу | Логин пользователя для подключения к прокси-серверу | Robin.String | Нет | Пароль пользователя для подключения к прокси-серверу | Пароль пользователя для подключения к прокси-серверу | Robin.Object | Нет |
| Результаты | ||||||||||||||||||||||
Статус ответа | Числовая переменная, в которую запишется код статуса ответа веб-сервиса. Возвращается всеми методами. | Robin.String | ||||||||||||||||||||
Заголовки ответа | Набор заголовков, получаемых от сервера, и их значения. Возвращается только методами: HEAD, OPTIONSвсеми методами. Если в ответе от сервера встречаются повторяющиеся заголовки, их значения собираются в отдельную коллекцию, которая сохраняется в словаре с заголовком в качестве ключа. | Robin.Dictionary | ||||||||||||||||||||
Тело ответа | Строковая переменная, в которую запишется тело ответа веб-сервиса в raw формате. Возвращается всеми методами | Robin.String | ||||||||||||||||||||
Идентификатор | Строковая переменная, в которую запишется идентификатор из заголовка ответа „Id“. Возвращается только методом POST | Robin.String | ||||||||||||||||||||
Location | Заголовок с указателем ресурса объекта. Имеет смысл для статусов 201, 3хх и только для метода POST | Robin.String | ||||||||||||||||||||
...
Особые условия использования
Действие вернет ошибку, если:
- "Путь до папки" заполнен некорректно.
- "Получить файл" - true, но на сервере нет данных о файле.
- "Перезаписать" - false, но файл с таким именем уже есть в папке.
Если в поле "Выбор прокси-сервера" выбран системный или без прокси, то поля (см. скрин), связанные с настройкой прокси-сервера игнорируются, даже если они чем-то заполнены.
Если отмечено Получить файл:
Необязательно, чтобы в ответе были какие-то определенные заголовки. Без заголовков сохранится просто файл без расширения. В ответе от сервера мы получаем просто набор байт, в нем могут присутствовать заголовки с именем и расширением файла, но они могут и отсутствовать. Если не будет указано иной информации, этот набор байт можно преобразовать в какой-нибудь файл с рандомным именем без расширения. Это и сохранится в результате.
Если пользователь пользователь указал в поле "Имя файла" неверное расширение, то скачанный файл не откроется. Изменить название и поставить правильное расширение уже можно будет после скачивания вручную.
Логика "Выбор прокси-сервера":
1. Системный прокси-сервер = что бы ни было заполнено в остальных полях, всегда используются системные настройки ОС.
2. Пользовательский прокси-сервер = поля настроек прокси заполнены - используем эти настройки для подключения к прокси.
3. Без прокси-сервера = ничего не заполнено - подключение без прокси, игнорируются данные параметров прокси, если даже заполнены.
Примеры использования
Пример 1
Отсутствуют.
Пример использования
Задача: отправить Задача: выполнить GET запрос к сервису https://gorestdadata.co.inru/public-api/users
Решение: воспользоваться действием "Отправить запрос".
Реализация:
- Перетащить на рабочую область действие "Отправить запрос" и заполнить поле "URL REST-сервиса" значением https://gorest.co.in/public-api/users
- Запустить робота по кнопке "Старт" в верхней панели.
Результат:
Действие отрабатывает успешно, выполняя GET запрос
Пример 2
Задача: выполнить GET запрос к сервису https://gorest.co.in/public-api/users, создавая файл с указанным именем в каждой указанной папке
api/find-party/ , сохранив результат ответа в файл формата json.
Решение: воспользоваться Решение: воспользоваться действием "Отправить запрос".
Реализация:
- Перетащить на рабочую область Перенести действие "Отправить запрос" и заполнить поле "URL REST-сервиса" значением https://gorest.co.in/public-api/users
- Заполнить параметр "Получить файл" = Истина
- Заполнить параметр "Путь до папки":
- Абсолютный путь C:\
- Относительный путь %userprofile%
- путь вида \\LKURAMSHINA-PC\Users\lkuramshina\folder
- Длина полного пути >244 и <260 символов - из переменной
- Заполнить параметр "Имя файла".
...
- на рабочую область и настроить его параметры.
- Нажать на кнопку "Старт" в верхней панели.
Результат:
Действие отрабатывает успешно, создавая файл с указанным именем в каждой указанной папке
...
- Повторить действия 1-2
- Корректно заполнить параметр "Путь до папки":
- Заполнить параметр "Имя файла"
- имя на кириллице без расширения: Тест
- имя на латинице с расширением txt: Test.txt
- имя на кириллице и латинице из переменной: TestТест123.txt
- имя с допустимыми символами: !№;%;.txt
- Запустить робота по кнопке "Старт" в верхней панели.
...
Действие отрабатывает успешно, создавая файл с указанным именем в указанной папке.
Пример 3
Задача: выполнить GET запрос к сервису https://gorest.co.in/public-api/users, успешно перезаписав файл
Решение: воспользоваться действием "Отправить запрос".
Реализация:
...
Программный робот отработал успешно.
Сохранен файл формата json с ответом от сервиса.
...
Обзор
Инструменты контента