Контракт описывает ресурсы/команды, поля, обязательность, коды ответов, идемпотентность, auth. SA отвечает за семантику бизнес-операций; синтаксис уточняет с разработкой (OpenAPI и т.п.).
Разбор
- Примеры запросов/ответов.
- Версии и совместимость.
- Ошибки бизнес vs транспорт.
- Consumer-driven согласование.
Итог
API-контракт — согласованная семантика операций и данных на границе.