Перейти к содержимому

Документация Corta

Шлюз интеграции

Шлюз интеграции Corta позволяет создавать собственные конечные точки (Endpoint), реализовывать индивидуальные методы аутентификации, валидации запросов и ограничения скорости обращений.

Интеграционный шлюз — это альтернатива стандартным точкам приёмника (sink endpoints).

Такие конечные точки могут быть использованы как индивидуальные точки для входящих вебхуков, для обработки данных от внешних интеграций или для проксирования запросов к другим сервисам.

Большинство стандартных задач можно реализовать с помощью встроенных функций Corta. Для сложных сценариев возможно использование JavaScript-скриптов или бизнес-процессов.

Создание новой конечной точки (Endpoint)

Чтобы создать новый endpoint, выполните следующие шаги:

Перейдите в вашу инстанцию Corta и запустите приложение Панель администратора.

В панели администратора откройте раздел Система → Шлюз интеграции.

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

Для создания новой точки нажмите кнопку Создать. Откроется окно, в котором задаются основные параметры конечной точки.

  • Путь (endpoint) — задаёт адрес конечной точки;
  • Метод (method) — определяет HTTP-метод (GET, POST, PUT и т.д.).

Для разных HTTP-методов на одном маршруте требуется создавать отдельные конечные точки: например, GET /customer и PUT /customer — это разные конечные точки шлюза интеграции.

После сохранения откроется дополнительный раздел Список фильтров — здесь вы можете настроить фильтры для проверки и обработки запросов и формирования ответов.

Валидация запросов

Валидация входящих запросов происходит с помощью префильтров. Они позволяют проверять запрос и определять, можно ли его обработать на выбранной конечной точке.

Виды префильтров:

  • По параметрам запроса

    Префильтр позволяет задать условие для обработки запроса на основании параметров строки запроса.
    Параметры так же передаются в выражения, как были заданы.

  • По заголовкам запроса

    Префильтр позволяет валидировать запрос по HTTP-заголовкам.

  • Профайлер

    Префильтр позволяет собирать статистику по маршруту: заголовки, тело запроса, длина контента, URI запроса и др.

Обработка запроса

Обработка запроса осуществляется с помощью обработчиков (processers).
Обработчик определяет основную бизнес-логику, выполняемую на endpoint. Corta позволяет принимать и обрабатывать как JSON-структуры, так и бинарные файлы.

Виды обработчиков:

  • Обработчик бизнес-процесса

    Привязывает бизнес-процесс к конечной точке.

  • Обработчик нагрузки

    Позволяет обрабатывать тело запроса с помощью JavaScript-выражений.

Формирование ответа

Формирование ответа реализуется с помощью постфильтров (postfilters), которые позволяют завершить цикл обработки запроса.

Виды постфильтров:

  • Редирект

    Добавляет в ответ необходимые HTTP-заголовки для перенаправления.

  • Ответ в формате JSON

    Формирует заголовки и возвращает результат обработки в формате JSON

Навигация по документу