История страницы
...
Send request Version 15 (Java)
Группа действийAction group: ИнтеграцииIntegrations
Описание
Действие отправляет HTTP-запрос для обращения к RESTful веб-сервису
Иконка действия
Параметры
Входные параметры
URL REST-сервиса - URL REST-сервиса
Метод - Определяет тип создаваемого запроса. По умолчанию Get.
Тело запроса - Тело отправляемого запроса. Позволяет отправить запрос в виде JSON строки.
Параметры запроса - Параметры строки запроса
Параметры формы - Параметры HTML формы для метода POST.
Авторизация - Словарь с параметрами авторизации - Basic или Bearer Token. В случае Basic авторизации словарь должен иметь ключи «user» и «pass», а значения элементов словаря должны содержать логин и пароль пользователя. В случае Bearer Token авторизации словарь должен иметь ключ «token», а значение элемента должно содержать Bearer Token.
Заголовки запроса - Набор заголовков отправляемого запроса и их значений. Каждый ключ – отдельный заголовок.
Путь к файлу для отправки методом POST - Путь к файлу, который нужно прикрепить к запросу.
Выбор прокси-сервера - Определяет настройки используемого прокси-сервера. Можно использовать системные настройки прокси, заданные на уровне ОС, либо настроить параметры пользовательского прокси-сервера, либо подключаться без прокси-сервера. По умолчанию используются системные настройки.
Протокол прокси- сервера - Протокол прокси-сервера. Например: http, https
Имя хоста или IP-адрес прокси-сервера - Имя хоста или IP-адрес прокси-сервера
Порт прокси-сервера - Порт прокси-сервера
Логин пользователя для подключения к прокси- серверу - Логин пользователя для подключения к прокси-серверу
Пароль пользователя для подключения к прокси-серверу - Пароль пользователя для подключения к прокси-серверу
Получить файл - Возможность получить файлы из запроса. Если выбрано значение «true», обязательно должны быть заполнены поля «Путь до папки» и «Имя файла».
Путь до папки - Путь к папке, в которой нужно сохранить полученный файл.
Имя файла - Поле для имени файла с расширением.
Перезаписать - Перезаписать существующий файл. В случае, если значение параметра false, а в указанной папке уже существует файл с таким же именем и расширением, то будет вызвана ошибка. Значение по умолчанию - false.
Отключить SSL - Отключить SSL. Если значение true, то отключается опция проверки SSL-сертификата. По умолчанию значение false.
Выходные параметры
Статус ответа - Числовая переменная, в которую запишется код статуса ответа веб-сервиса. Возвращается всеми методами.
Заголовки ответа - Набор заголовков, получаемых от сервера, и их значения. Возвращается всеми методами. Если в ответе от сервера встречаются повторяющиеся заголовки, их значения собираются в отдельную коллекцию, которая сохраняется в словаре с заголовком в качестве ключа.
Тело ответа - Строковая переменная, в которую запишется тело ответа веб-сервиса в raw формате. Возвращается всеми методами
Идентификатор - Строковая переменная, в которую запишется идентификатор из заголовка ответа „Id“. Возвращается только методом POST
Location - Заголовок с указателем ресурса объекта. Имеет смысл для статусов 201, 3хх и только для метода POST
Настройки
...
Description
The action sends an HTTP request to invoke a RESTful web service
Action icon
Settings of parameters
Property | Description | Type | Filling example | Mandatory field |
Parameters | ||||
Endpoint URL | Endpoint URL | Robin.String | Yes | |
Method | The method of request being created. By default, |
Свойство
Описание
Тип
Пример заполнения
Обязательность заполнения поля
Параметры
URL REST-сервиса
URL REST-сервиса
Robin.String
Да
Метод
Get. | Robin.String |
No |
Тело запроса
Request body | The body of the request to be sent. Allows you to send a request as a JSON stringy | Robin.String |
No |
Параметры запроса
Query Parameters | Query Parameters | Robin.Dictionary |
No |
Параметры формы
Form Parameters | Form Parameters of POST method | Robin.Dictionary |
No |
Авторизация
Authorization | Dictionary with authorization parameters - Basic |
or Bearer Token. |
In the case of Basic authorization, the dictionary must have the keys «user» and «pass», and the values of the dictionary elements must contain the username and password. In case of Bearer Token authorization, the dictionary must have the «token» key, and the element value must contain the Bearer Token. | Robin.Dictionary |
No |
Заголовки запроса
Request Headers | Request Headers | Robin.Dictionary |
Нет
Путь к файлу для отправки методом POST
No | ||
File path for sending by POST method | The path to the file to be attached to the request | Robin.FilePath |
Нет
Выбор прокси-сервера
No | ||
Proxy server settings | Specifies the settings for the proxy server to use. You can use the system proxy settings set at the OS level, or configure custom proxy settings, or connect without a proxy server. The system settings are used by default. | Robin.String |
Нет
No | |
Proxy server protocol | The protocol of the proxy server. For example, |
Протокол прокси- сервера
http, https | Robin.String |
Нет
Имя хоста или IP-адрес прокси-сервера
No | |
The hostname, or address, of the proxy server | The hostname, or address, of the proxy server |
Robin.String |
Нет
No | |
The port number of the proxy server | The port number of the proxy server |
Порт прокси-сервера
Robin.String |
Нет
Логин пользователя для подключения к прокси- серверу
No | |
The username of the proxy server | The username of the proxy server |
Robin.String |
Нет
Пароль пользователя для подключения к прокси-серверу
No | |
The password of the proxy server | The password of the proxy server |
Robin.Object |
No |
Получить файл
Get file | Ability to get files from a request. If «true» is selected, the «Path to folder» and «File name» fields must be filled in. | Robin.Boolean | true |
Нет
No | |
Path to file | The path to the folder where the resulting file should be saved |
Путь до папки
. | Robin.FolderPath | C:\doc\img |
No |
Имя файла
File name | A field for the file name with an extension. | Robin.String |
No |
Перезаписать
Overwrite | Overwrite existing file. If the value of the parameter is false, and a file with the same name and extension already exists in the specified folder, an error will be raised. The default value is false. | Robin.Boolean | true |
No |
Disable SSL |
Disable SSL. |
If the value is true, |
then SSL certificate verification will be skipped. The default value is false. | Robin.Boolean | true |
No |
Results |
Статус ответа
Response status | Response status code. Returned by all methods |
. | Robin.String |
Заголовки ответа
Response Headers. | Response Headers. Returned by all methods. If there are repeated headers in the response from the server, their values are collected into a separate collection, which is stored in the dictionary with the header as the key. | Robin.Dictionary |
Тело ответа
Response body | Response body. Returned by all methods |
Robin.String |
Идентификатор
Identificator | A string variable to which the identifier from the "Id" response header will be written. Returned by POST method only |
Robin.String |
Location
Указатель ресурса | The Location response header indicates the URL to redirect a page to. It only provides a meaning when served with a 3xx (redirection) or 201 (created) status response and only for POST method. | Robin.String |
Особые условия использования
Подробнее о REST: https://ru.wikipedia.org/wiki/REST
Пример использования 1
Задача
Special conditions of use
Read more about REST.
Example of use 1
Task
Send a GET request to отправить GET запрос к сервису https://dadata.ru/api/find-party/ , сохранив результат ответа в файл формата json.
Решение
воспользоваться действием "Отправить запрос".
Реализация
, saving the result of the response to a json file.
Solution
Use the "Send request" action.
Implementation
- Move the "Send request" action to the workspace and set its parameters.
The "Endpoint URL" field is the address to connect to. More detailed information about the method can be found at the following link
- Перенести действие "Отправить запрос" на рабочую область и настроить его параметры.
Поле "URL REST-сервиса" - это адрес, к которому необходимо подключиться. Более подробная информация о методе находится по ссылке: https://dadata.ru/api/find-party/. Поле
The "МетодMethod" - в нашем случае необходимо указать значение GETfield - in our case it is necessary to specify the GET value. Поле
"Получить файлGet file" - необходимо проставить чек-бокс при необходимости. Используется, когда необходимо получить файл от сервиса. Весь ответ от сервиса будет записан в отдельный файл.
Поле "Путь до папки" и "Имя файла" - необходимо заполнить, если проставлен чек-бокс в поле "Получить файл". В поле "Имя файла" необходимо указать расширение.
- Нажать на кнопку "Старт" в верхней панели.
Результат
Программный робот отработал успешно. Сохранен файл формата json с ответом от сервиса.
Пример использования 2
Задача
field - it is necessary to check the checkbox if necessary. It is used when it is necessary to receive a file from the service. The whole response from the service will be written to a separate file.
The "Path to file" and "File name" fields - must be filled in if the checkbox in the "Get file" field is checked. In the "File name" field it is necessary to specify the extension.
- Click on the "Start" button in the top panel.
Result
The program robot completed successfully. A .json file with the response from the service was saved.
Example of use 2
Task
Send a POST request to the отправить POST запрос к сервису http://shop.bugred.ru/api/items/search/, для получения актуальных данных об изделии и разобрать ответ от сервиса, сохранив результат ответа в файл .txt.
Решение
воспользоваться действием "Отправить запрос".
Реализация
Перенести действие "Отправить запрос" на рабочую область и настроить его параметры.
service to retrieve actual product data and parse the response from the service, saving the result of the response to a .txt file.
Solution
Use the "Send request" action.
Implementation
Move the "Send request" action to the workspace and set its parameters.
- Поле "URL REST-сервиса" - это адрес, к которому необходимо подключиться (REST запрос) — The "Endpoint URL" field is the address to connect to (REST request) - http://shop.bugred.ru/api/items/search/. Более подробная информация о методе находится по ссылке: https://testbase.atlassian.net/wiki/spaces/SHOP/pages/1957464487/Search.
- Поле "Метод" - в нашем случае необходимо указать значение POST.
- More detailed information about the method can be found at the following link.
- The "Method" field - in our case we need to specify the POST value.
- Field "Request body" - it is necessary to specify the text of the request bodyПоле "Тело запроса" - необходимо указать текст тела запроса. {"query": "Шорты-юбкаSkirt shorts"}Поле
- Field "Заголовки запроса" - словарь, в котором необходимо указать название заголовков и их ключи. В нашем случае словарь из 2-х записей. Пример заполнения поля "Заголовки запроса":
Все остальные поля не имеют отношения к смыслу запроса и его формату. Поля начиная с "Выбор прокси-сервера" и заканчивая полем "Пароль пользователя для подключения к прокси-серверу" - это все поля, которые относятся к настройке прокси-сервера, если он необходим. В нашем случае, прокси-сервер отсутствует.
Поле "Получить файл" - необходимо проставить чек-бокс при необходимости. Используется, когда необходимо получить файл от сервиса. Весь ответ от сервиса будет записан в отдельный файл.
Поле "Путь до папки" и "Имя файла" - необходимо заполнить, если проставлен чек-бокс в поле "Получить файл". В поле "Имя файла" необходимо указать расширение.
Поле "Перезаписать" необходимо на тот случай, если в данной папке уже содержится файл с таким же названием и расширением.
При запуске робота необходимо нажать на кнопку "Старт" в верхней панели.
Результат
робот отработал успешно. Ответ от сервиса разобран роботом.
Пример использования 3
Задача
необходимо отправить rest-запрос на сервис https://dadata.ru/ для получения актуальных данных об организации и разобрать ответ от сервиса.
В решении указано, как верно заполнить параметры для конкретной задачи, а так же рассмотрены остальные параметры.
Решение
- Request Headers" - a dictionary in which you need to specify the name of headers and their keys. In our case, a dictionary of 2 records. Example of filling in the "Request Headers" field:
All other fields are irrelevant to the meaning of the request and its format. The fields starting from " Proxy server settings" and ending with the field "The password to the proxy server" are all fields that are related to proxy server configuration, if it is required. In our case, there is no proxy server.
"Get file" field - it is necessary to check the checkbox if necessary. It is used when it is necessary to receive a file from the service. The whole response from the service will be written to a separate file.
The "Path to file" and "File name" fields - must be filled in if the checkbox in the "Get file" field is checked. In the "File name" field it is necessary to specify the extension.
The "Overwrite" field is necessary in case this folder already contains a file with the same name and extension.
When launching the robot, you need to click on the "Start" button in the top panel.
Result
The robot completed successfully. The response from the service is parsed by the robot.
Example of use 3
Task
It is necessary to send rest-request to the service https://dadata.ru/ to get actual data about the organization and parse the response from the service.
The solution shows how to correctly fill in the parameters for a particular task, as well as other parameters are considered.
Solution
Use the "Send request" action. The entire workflow is shown in the robot's flowchart воспользоваться действием "Отправить запрос". Весь процесс представлен в схеме робота rest-zapros.robin-source . Перенести действие "Отправить запрос" на рабочую область и настроить его параметры
Transfer the "Send request" action to the workspace and customize its parameters.
...
Result
Let's look at the action parameters in detail
- The "Endpoint URL" field is the address to connect to. We will connect to the dadata service. The body of the request looks like one line. The data is formed in JSON format.
- The "Method" field - in our case we need to specify the POST value.
- The "Request body" field - it is necessary to specify the text of the request body. If the parameters should be passed not in the body, but in the URL, then in this case the parameters of the request should be specified in the URL. It depends on the service, i.e. how the service expects to receive the request (in the body of the request or in the URL).
- The "Form Parameters" field - in this field you can fill in the values for the request body. Difference from the "Request body" field: "Request body" is a string, "Form parameters" is a dictionary. The "Form parameters" field is used for POST method. The dictionary contains JSON object names, element names and further values for these elements.
- The "Query parameters" field - is needed in case the service expects that the parameters of the request will be passed through the URL, and not through the body of the request.
- The "Request Headers" field is a dictionary in which you need to specify the name of headers and their keys. In our case, the dictionary consists of 3 entries:
- Example of filling in the "Request Headers" field:
- One of the headers is the header with authorization. It can be specified in the "Authorization" field, but it will not be an error if this header is specified in the "Request Headers" field.
- Field "File path for sending by POST method"- it is necessary to specify the path to the file with the request, if it is required.
- All other fields are irrelevant to the meaning of the request and its format. Fields from "Proxy server settings" to "The password of the proxy server" are all fields that are related to proxy server configuration, if it is required
- In the "Proxy server settings" field you should choose which option to use
- If the system proxy server is selected, the server settings that are set in your system under which the robot is running will be used.
- If "Without proxy" is selected, neither system settings nor any other settings are used. then neither system settings nor any other settings will be used.
- If "System proxy" or " Without proxy" is selected, the fields below can be left blank.
- Only if "Custom proxy" is selected, the fields below must be filled in (highlighted on the screen).
- Other fields are related to receiving a file from the service.
- The"Get file" field - it is necessary to check the checkbox if necessary. It is used when it is necessary to receive a file from the service. The whole response from the service will be written to a separate file.
- The "Path to file" and "File name" fields - must be filled in if the checkbox is checked in the "Get file" field. In the "File name" field it is necessary to specify the extension.
- The "Overwrite" field is necessary in case this folder already contains a file with the same name and extension
- When launching the robot, you need to click on the "Start" button in the top panel.
Result
The robot completed successfully. The response from the service is parsed by the robot.
- Поле "URL REST-сервиса" - это адрес, к которому необходимо подключиться. Подключаться мы будем к сервису dadata. Тело запроса выглядит в одну строчку. Данные формируются в формате JSON.
- Поле "Метод" - в нашем случае необходимо указать значение POST.
- Поле "Тело запроса" - необходимо указать текст тела запроса. Если параметры должны быть переданы не в теле, а в URL, то в этом случае параметры запроса необходимо указать сразу в URL. Зависит это от сервиса, т.е как сервис ожидает получить запрос (в теле запроса или в URL).
- Поле "Параметры формы" - в данном поле можно заполнить значения для тела запроса. Отличие от поля "Тело запроса" : "Тело запроса"- это строка, "Параметры формы" - словарь. Поле "Параметры формы" используется для метода POST. В словаре указываются в виде ключей названия объектов JSON , название элементов и далее значения по этим элементам.
- Поле "Параметры запроса" - нужно на тот случай, если сервис ожидает, что параметры запроса будут переданы через URL, а не через тело запроса.
- Поле "Заголовки запроса" - словарь, в котором необходимо указать название заголовков и их ключи. В нашем случае словарь из 3-х записей:
- Пример заполнения поля "Заголовки запроса":
- Один из заголовков - это заголовок с авторизацией. Его можно указать в поле "Авторизация", но так же ошибкой не будет, если данный заголовок будет указан в поле "Заголовки запросов".
- Поле "Путь к файлу для отправки методом POST"- необходимо указать путь до файла с запросом, если он требуется.
- Все остальные поля не имеют отношения к смыслу запроса и его формату. Поля начиная с "Выбор прокси-сервера" и заканчивая полем "Пароль пользователя для подключения к прокси-серверу" - это все поля, которые относятся к настройке прокси-сервера, если он необходим
- В поле "Выбор прокси-сервера" необходимо выбрать какой вариант использовать
- Если системный прокси-сервер, то будут использоваться настройки сервера, которые установлены в самой вашей системе под которой работает робот.
- Если выбрано значение "Без прокси-сервера" , то в этом случае не используются ни системные настройки , ни какие-либо другие.
- При выборе значений "Системный прокси-сервер" или "Без прокси-сервера", поля ниже можно не заполнять.
- Только если выбрано значение "Пользовательский прокси-сервер" необходимо заполнить поля ниже (выделены на скрине).
- Остальные поля связаны с получением файла от сервиса.
- Поле "Получить файл" - необходимо проставить чек-бокс при необходимости. Используется, когда необходимо получить файл от сервиса. Весь ответ от сервиса будет записан в отдельный файл.
- Поле "Путь до папки" и "Имя файла" - необходимо заполнить, если проставлен чек-бокс в поле "Получить файл". В поле "Имя файла" необходимо указать расширение.
- Поле "Перезаписать" необходимо на тот случай, если в данной папке уже содержится файл с таким же названием и расширением
- При запуске робота необходимо нажать на кнопку "Старт" в верхней панели.
Результат
робот отработал успешно. Ответ от сервиса разобран роботом.