Контракт
Определение
Контракт (англ. contract) — договоренность о том, как две части системы обмениваются данными: какие запросы принимаются, какие поля в них обязательны, какие ответы и ошибки возможны. Чаще всего контракт описывает API и фиксируется в формате OpenAPI, а в коде ему соответствуют DTO. Пример: контракт говорит, что запрос на создание заказа содержит список товаров, адрес и телефон, а в ответ приходит номер заказа. Когда контракт согласован до начала работ, команды фронтенда, бэкенда и внешний партнер работают параллельно и сходятся без сюрпризов. Изменение контракта без предупреждения ломает все системы, которые от него зависят, поэтому новые версии выпускают отдельно. Хороший контракт продлевает жизнь интеграции.
Также говорят
контракт API, апи-контракт.