Описание контрактов — только бизнес-языком или также в OpenAPI (JSON, обязательность, паттерны)?

Описание контрактов должно быть комплексным: бизнес-язык важен для понимания требований и целей, а спецификация в OpenAPI (JSON или YAML) — для точного технического описания API.

В OpenAPI указываются:

• Типы данных (string, integer и т.д.)
• Обязательность полей (required)
• Паттерны (регулярные выражения для валидации формата)

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

Таким образом, бизнес-язык задаёт контекст и логику, а OpenAPI — техническую спецификацию, которая обеспечивает точность и автоматизацию.