Как вообще фиксируется интеграционный контракт? Как вы описывали взаимодействие?

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

• OpenAPI/Swagger для REST API — описывает эндпоинты, методы, структуры данных, коды ответов.
• WSDL для SOAP-сервисов.
• JSON Schema или XML Schema для описания формата сообщений.
• Документ с описанием бизнес-правил и сценариев взаимодействия.

Взаимодействие описывается через:

• Контракты данных (структуры сообщений, обязательные поля, типы данных).
• Протоколы передачи (HTTP, AMQP, gRPC и т.п.).
• Соглашения по ошибкам и обработке исключений.
• Соглашения по версиям API.

Пример: для REST API создается OpenAPI спецификация, которая служит единой точкой правды для разработчиков обеих сторон.