MTB ESB Documentation
Единая точка входа в архитектуру, подключение Consumer, публикацию API и эксплуатацию MTB ESB Next Gen.
Интеграционная платформа банка — от API-контракта до эксплуатации
MTB ESB Next Gen объединяет WSO2 API Manager, Apache Kafka, Event Router, Kestra, адаптеры и Callback Service в управляемый интеграционный контур.
Этот портал помогает быстро ответить на три вопроса: как подключиться, как опубликовать API и как безопасно сопровождать интеграцию.
Главный принцип
Consumer работает со стабильным API через WSO2. Внутреннюю доставку, маршрутизацию, оркестрацию и связь с банковскими системами обеспечивает платформа.
С чего начать
Я подключаю приложение
Заявка, доступ, Developer Portal, первый вызов, Sandbox и Production.
Я создаю или публикую API
Design, OpenAPI, Publisher, security policies, lifecycle и delivery.
Я сопровождаю платформу
Observability, диагностика, incident response, rollback и recovery.
Платформа одним взглядом
| Уровень | Ответственность |
|---|---|
| WSO2 API Manager | Единая точка входа, authentication, authorization, policies и API lifecycle |
| Event Router + Kafka | Управляемый маршрут и транспорт сообщений |
| Kestra | Многошаговая оркестрация и обработка сложных процессов |
| Adapters | Изоляция протоколов и моделей целевых банковских систем |
| Callback Service | Надёжная асинхронная доставка результата Consumer |
| Observability | Сквозные metrics, logs и distributed traces |
Документация по разделам
Introduction
Цели, границы, архитектура, интеграционные потоки, компоненты и окружения.
Consumer Onboarding
Путь нового Consumer от заявки до Production readiness.
API Publishing
Путь API от design request до публикации и продвижения по окружениям.
Architecture & Standards
API design, messaging, tracing, idempotency, reliability, data и naming.
Operations & Reference
Эксплуатационная модель, runbooks, recovery и платформенные каталоги.
Основные интеграционные потоки
| Flow | Когда применяется | Ключевой маршрут |
|---|---|---|
| Direct | Одна логически завершённая операция | WSO2 → Router/Kafka → Adapter |
| Async | Результат приходит после подтверждения приёма | WSO2 → Kafka → Adapter → Callback |
| Orchestrated | Несколько шагов, систем или компенсация | WSO2 → Kafka → Kestra → Adapters |
Платформенные правила
- API начинается с согласованного контракта и владельца.
- WSO2 не используется для сложной доменной бизнес-логики.
X-Consumer-ID,X-External-Request-ID,traceparentиIdempotency-Keyимеют разные назначения.- Timeout, retry, DLQ и idempotency проектируются до реализации.
- Dev, Stage и Prod разделены; артефакты продвигаются контролируемо.
- Секреты и чувствительные payload не размещаются в документации и логах.
Статус и актуальность
Утверждённые policies имеют приоритет над черновыми проектными материалами. Если страницы или источники расходятся, зарегистрируйте конфликт и уточните действующее решение у владельца соответствующего раздела.