Перехват ошибок HTTP-коннектора

Узнайте, в каких случаях можно поймать ошибку HTTP API Connector, а также как зарегистрировать ошибку и повторить выполнение функции коннектора.

Типы ошибок HTTP-коннектора

В стандарт протокола HTTP включено требование о наличии кода ответа сервера и сообщения, известных как HTTP Response Code и HTTP Response Message. При этом существуют стандартные классы кодов ответов HTTP, или категории, которые помогают конечным пользователям интуитивно определить тип возникшей ошибки.
Эти коды включают следующие: * 1xx - информационный ответЗапрос был получен, продолжаем обработку * 2xx - успешноЗапрос был успешно получен, понят и принят * 3xx - перенаправлениеДля завершения запроса необходимо предпринять дополнительные действия * 4xx - ошибка клиентаЗапрос содержит плохой синтаксис или не может быть выполнен * 5xx - ошибка сервераСерверу не удалось выполнить, по-видимому, правильный запрос

Наиболее распространенными кодами ошибок являются 404 - Not Found или 500 - Internal Server Error. Эти коды ошибок могут указывать на то, что сервер внешней системы не работает, проводится техническое обслуживание, возникла проблема с сервисом или проблема с сетью.

Пример: Перехват HTTP-ошибок в приложении

В следующем примере подробно описано, как настроить приложение для отображения ошибок функции коннектора HTTP.

Создание функции коннектора

В конструкторе функций коннектора вы можете сопоставить код ошибки HTTP и сообщение об ошибке в конфигурации коннектора Output. Это позволит передать код ошибки HTTP и сообщение об ошибке в качестве выходов функции коннектора, которые впоследствии будут использоваться в приложениях Tulip Apps.

1. Соотнесите поля состояния HTTP с выходами.
2. Дайте выводам четкое, понятное имя и повторно запустите функцию коннектора, чтобы проверить, правильно ли отображается вывод.

Это будет выглядеть так, как показано в следующем примере:

Создание приложения для обработки ошибок коннектора

Используйте информацию из выходов коннектора в приложениях для обработки ошибок коннектора.

Запуск коннектора в триггере приложения

Создайте триггерное действие с помощью функции Run Connector Function. Выберите коннектор и функцию, которую вы только что создали, а затем сохраните результат как переменную.

Код ответа HTTP и сообщение теперь доступны в качестве ссылки в новой переменной приложения.

Визуализация ответа коннектора в приложении

Разместите виджет Variable на шаге приложения, который отображает всю переменную Connector Response.

Создание триггера обработки ошибок коннектора

Далее вы можете использовать код HTTP-ответа для выполнения обработки ошибок на уровне приложения по последующему условию триггера.

1. Создайте новый триггер для выполнения обработки ошибок коннектора.
2. Создайте условие, которое будет искать неправильный код ответа HTTP. В этом примере условие ищет ответы, которые не равны 200.:::(Info) (Примечание) Многие системы используют код ответа 200 как хороший ответ, но лучше уточнить у поставщика конечной точки API или у ИТ-специалистов, все ли хорошие ответы будут только с кодом 200 :::
3. Создайте триггерное действие, которое будет происходить при выполнении условия, когда код ответа HTTP будет плохим.

Вот как это выглядит в приложении:

Дальнейшее чтение

• Как создать и настроить функцию HTTP-коннектора
• Как форматировать выходные данные HTTP-коннектора
• Использование HTTP-коннекторов в приложениях