Вопрос проверяет умение работать с API как с продуктом, а не просто набором обработчиков.
Проектирование API-контракта заранее позволяет согласовать формат данных и поведение системы до написания кода. Это снижает количество переделок и конфликтов между командами. Клиенты могут начинать разработку параллельно с backend. В итоге ускоряется разработка и повышается стабильность API.
API-контракт — это соглашение между сервером и клиентом, и его изменения дороги.
Перед реализацией важно зафиксировать ожидания всех сторон.
Снижение стоимости изменений
изменения на бумаге дешевле
меньше рефакторинга
Параллельная разработка
фронтенд и backend работают независимо
можно использовать mock-серверы
Чёткие границы ответственности
понятно, кто за что отвечает
меньше спорных ситуаций
Качество и консистентность API
единый стиль ошибок
единые форматы данных
Хорошо спроектированный контракт:
проще версионировать
легче документировать
стабильнее поддерживать
API-контракт — это фундамент системы, и его проектирование до реализации экономит время и снижает риски.
