PORTcore
+7 900 228-04-13

Подключение отраслевых систем

Интеграция отраслевых API и внутренних сервисов

Встраиваем внешние справочники и отраслевые сервисы в ваш продукт с учётом их правил, лимитов и качества данных.

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

У специализированного API часто свои особенности: неполная документация, длительное выполнение операции, закрытые справочники и разные версии протокола. Проверяем рабочий сценарий на тестовом контуре до включения в основной процесс.

Чужое API становится частью вашего процесса

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

Для внутреннего API описываем владельца контракта и порядок изменений. Это особенно важно, когда две системы сопровождают разные подрядчики и выпуск одной не должен неожиданно ломать другую.

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

Интеграция отраслевых API и внутренних сервисов: адаптер отделяет отраслевое API от продукта. Схема PORTcore — portcore.ru.
Адаптер отделяет отраслевое API от продукта. Изменения внешнего формата и временные отказы обрабатываются на определённой границе, а не разрозненными исключениями в продукте.

Граница между вашей системой и поставщиком

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

Что останется после подключения

  • Контракт данных и примеры реальных обезличенных запросов.
  • Журнал операций и связь внешних идентификаторов с внутренними.
  • Правила тайм-аутов, повторов и ручного восстановления.
  • Проверки совместимости при обновлении API.

Если сторонний сервис недоступен, заранее определяем допустимое поведение: остановка, очередь или ограниченный режим. Возможность такого режима зависит от операции, а не от пожелания «чтобы всегда работало».