- Распечатать
Узнайте, в каких случаях можно поймать ошибку 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.
- Соотнесите поля статуса HTTP с выходами.
- Дайте выходным данным четкое и понятное имя и повторно запустите функцию коннектора, чтобы проверить, правильно ли они отображаются.
Это будет выглядеть так, как показано в следующем примере:
Создание приложения для обработки ошибок коннектора
Используйте информацию о выходах коннектора в приложениях для обработки ошибок коннектора.
Запуск коннектора в триггере приложения
Создайте триггерное действие с помощью функции Run Connector Function. Выберите коннектор и функцию, которую вы только что создали, а затем сохраните результат как переменную.
Код ответа HTTP и сообщение теперь доступны в качестве ссылки в новой переменной приложения.
Визуализация ответа коннектора в приложении
Разместите виджет Variable на шаге приложения, который отображает всю переменную Connector Response.
Создание триггера обработки ошибок коннектора
Далее вы можете использовать код HTTP-ответа для выполнения обработки ошибок на уровне приложения по последующему условию триггера.
- Создайте новый триггер для выполнения обработки ошибок коннектора.
- Создайте условие, которое будет искать неправильный код ответа HTTP. В этом примере условие ищет ответы, не равные 200.::::(Info) (Note)
Many systems use a 200 response code as a good response, but it is best to check with the API endpoint provider or IT if all good responses will only be of code 200
::: - Создайте триггерное действие, которое будет происходить при выполнении условия, когда код ответа HTTP будет плохим.
Вот как это выглядит в приложении:
Дальнейшее чтение
- Как создать и настроить функцию HTTP-коннектора
- Как форматировать выходные данные HTTP-коннектора
- Использование HTTP-коннекторов в приложениях