Подключение REST-сервиса

Задаются параметры подключения, запроса и ответа REST-сервиса. Выходные данные подключения используются узлом REST-запрос.

Параметры подключения

• URL сервиса — задается адрес отправки запросов к REST-сервису.

• Метод — выбирается один из HTTP-методов, используемых при отправке запросов к сервису: GET, DELETE, POST, PUT, PATCH.

  • При выборе методов GET, DELETE доступны настройки:
    • Допустимый Content-type ответа — узел REST-запрос, использующий данное подключение, проверяет тип ответа на соответствие заявленному в данном параметре. При несоответствии типов выходной набор этого узла будет содержать сообщение об ошибке. Данная проверка не осуществляется, если параметр имеет значение */*.
    • Параметры запроса — задается перечень параметров запроса, их имена и типы данных. В последующем, в узле вызова REST-сервиса значения параметров подставляются в URL запроса.
  • При выборе методов POST, PUT, PATCH доступны настройки:
    • Тип Content-type запроса — задается значение заголовка Content-type HTTP-запроса к REST-сервису. Доступен как выбор из списка предопределенных значений, так и ввод произвольного значения.
    • Допустимый Content-type ответа — то же, что и для GET, DELETE методов (см. выше).
• Таймаут подключения (мсек) — максимальное время установки TCP-соединения с сервером в миллисекундах, по истечении которого соединение будет прервано со статусом ошибки. Если параметр равен нулю, то таймаут не ограничен.
• Таймаут обмена данными (мсек) — максимальное время, которое будет затрачено на отправку HTTP-запроса и получение ответа, по истечении которого обмен будет прерван со статусом ошибки. Если параметр равен нулю, то таймаут не ограничен.
• Игнорировать ошибки SSL сертификата — если данный флаг установлен, то ошибки при проверке сертификата сервера, к которому производится подключение, игнорируются.

Авторизация при выполнении запроса

• Тип авторизации — представляет выпадающий список с вариантами авторизации:
  • Не требуется — при выборе этого пункта Loginom не проводит авторизацию при подключении к сервису.
  • Имя пользователя и пароль — выбирается, если требуется авторизация по имени/паролю. Поддерживаются следующие типы авторизации по имени пользователя и паролю:
    • Basic;
    • Digest;
    • NTLM;
    • Passport;
    • Negotiate.
  • Токен OAuth — выбирается при подключении к веб-сервису посредством протокола OAuth версии 2.0.
  • Предоставить сертификат клиента — выбирается для авторизации по SSL посредством сертификата.
• Имя пользователя, Пароль — поле становится активным, если выбран тип Имя пользователя и пароль. Задают параметры авторизации пользователя при его регистрации в системе веб-сервиса.
• Токен OAuth — поле становится активным, если выбран тип Токен OAuth. Вводится строка токена.
• Хранилище сертификатов — выпадающий список, который становится доступен при выборе Предоставить сертификат клиента. Из списка выбирается одно из хранилищ сертификатов, имеющихся в системе. Затем в таблице под списком выбирается используемый для авторизации сертификат.