API запрос

1. Укажите адрес сервиса в поле «Ссылка запроса».
2. При необходимости используйте переменные.
3. Выберите тип HTTP-запроса:
   • GET — получение ресурса;
   • POST — передача данных или создание ресурса;
   • PUT — полное обновление ресурса;
   • PATCH — частичное обновление ресурса;
   • DELETE — удаление ресурса.

Добавьте тело запроса во вкладке «Body» в формате JSON.

Пример:

{
"params": {
"chat_id": "{{id_chat}}",
"context_id": 1,
"messenger_type": "{{messenger_type}}"
}
}

1. Перейдите во вкладку «Headers» для добавления заголовков.
2. Перейдите во вкладку «Params» для добавления параметров запроса.
3. Укажите:
   • название параметра в поле «Keys»;
   • значение в поле «Values».

При необходимости используйте переменные.

1. Откройте вкладку «Testing».
2. Нажмите «Отправить тестовый запрос».

Ответ сервера в формате JSON отобразится в поле «Результат».

Если в теле запроса допущена ошибка, система отобразит сообщение: Your request body is invalid json

Для повторной отправки запроса нажмите кнопку повторной отправки.

Чтобы сохранить значения ответа в переменные:

1. Откройте вкладку «Mapping».
2. Можете дополнительно «Передать данные из тестирования», в таком случае будут добавлены значения, которые получены во время тестирования.
3. Укажите диалоговые переменные для необходимых значений.

Если значение не требуется сохранять:

• оставьте поле переменной пустым;
• или укажите путь вручную в формате: $.значение

Также результат запроса доступен в результате «data» блока, подробнее в статье «Результаты блоков».

Подключение прокси (Proxy)

Раздел Proxy предназначен для настройки подключения через промежуточный сервер при выполнении HTTP-запросов из сценария. В этом разделе можно указать параметры прокси, через который будет проходить запрос перед отправкой в целевой API. При включении опции «Использовать прокси» становятся доступны поля для ввода адреса? порта сервера и учетных данных (логин и пароль) для авторизации. Все запросы из данного блока будут направляться через указанный прокси-сервер. Это может быть полезно, например, если требуется маршрутизация трафика через внешний сервер, использование фиксированного IP-адреса или работа с API, доступ к которому ограничен по сети.

В разделе поддерживается протокол SOCKS5, что позволяет гибко настраивать соединение и использовать современные прокси-серверы для передачи данных.

Обеспечение доступности внешних сервисов

В системе реализован механизм повышения стабильности доступа к внешним ресурсам. При обращении к сайту:

• сначала выполняется прямой запрос
• при возникновении ошибок соединения система автоматически использует альтернативные маршруты
• при успешном ответе выбранный маршрут будет использован для последующих запросов к внешнему ресурсу

Это позволяет повысить надёжность работы интеграций с внешними сервисами.