MENU
    Перехват ошибок HTTP-коннектора
    • 08 Jan 2025
    • 2 Минуты для чтения
    • Авторы

    Перехват ошибок 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 с выходами.Connector Output Mapping 1.png
    2. Дайте выходным данным четкое и понятное имя и повторно запустите функцию коннектора, чтобы проверить, правильно ли они отображаются.Connector Output Mapping 2.png

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

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

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

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

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

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

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

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

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

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

    1. Создайте новый триггер для выполнения обработки ошибок коннектора.Connector Error Handling Trigger.png
    2. Создайте условие, которое будет искать неправильный код ответа 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
      :::
    3. Создайте триггерное действие, которое будет происходить при выполнении условия, когда код ответа HTTP будет плохим.Bad Response Code Trigger.png

    Вот как это выглядит в приложении:HTTP Error Response Overview.gif

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


    Была ли эта статья полезной?