Ответы API

← К концепции

Ответ — публичный контракт

Используем стабильные типизированные формы ответа. Проверяем внешние данные на границе. Поля ownership, ревизии, пагинацию и смысл ошибок задаём намеренно и документируем.

API-адаптер сообщает о транспортном сбое, но не выбирает представление UI. Домен интерпретирует ожидаемый результат; граница приложения отвечает за сообщения или навигацию. Успешный HTTP-статус не должен скрывать некорректные обязательные данные.

Перед изменением публичного ответа находим всех потребителей. Согласованно обновляем сериализаторы, генерируемые типы, моки и тесты поведения. Медиа-сериализаторы возвращают относительные пути хранения, а не адрес внутреннего сервера.