PORTcore
+7 900 228-04-13

Одна управляемая точка доступа к API

Единый API-шлюз для внешних систем

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

Единый API-шлюз для внешних систем: согласованное соединение программных систем. PORTcore — portcore.ru.
Иллюстрация к услуге «Единый API-шлюз для внешних систем».

Шлюз полезен, когда внешним системам приходится знать адреса и особенности нескольких ваших сервисов. Он даёт стабильный вход, но не должен превращаться в скрытый монолит бизнес-логики.

Что выносим на границу

Аутентификацию, квоты, версионирование, маршрутизацию и корреляционный идентификатор. Согласуем формат ошибок и правила совместимости при обновлении внутренних сервисов.

Граница между внешними клиентами и внутренними сервисами

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

Для разных партнёров могут понадобиться отдельные квоты и версии API. Продумываем отзыв ключа, переход на новый контракт и диагностику обращения без записи секретов в логи. Если внутренний сервис недоступен, клиент получает определённую ошибку и понятное правило повтора. В состав подключения входят примеры запросов и наблюдаемость: технической поддержке нужен способ проследить путь запроса по всем участникам.

Публичная ошибка должна сообщать достаточно для исправления запроса и не раскрывать внутренние адреса или ключи. Для разработчиков партнёра готовим примеры типовых отказов. Метрики шлюза отделяют лимиты, ошибки авторизации и недоступность сервиса: общее число ответов 500 не помогает выбрать владельца проблемы и восстановить работу.

Единый API-шлюз для внешних систем: aPI-шлюз задаёт общую границу доступа. Схема PORTcore — portcore.ru.
API-шлюз задаёт общую границу доступа. Единый адрес не скрывает неопределённую бизнес-логику. Шлюз помогает маршрутизировать запрос и проследить его выполнение.