Лекция 5. Контракт наружу

Материал в работе. Ниже — план содержания, зафиксированный при проектировании курса. Он может измениться по ходу семестра; окончательная версия появится здесь до занятия.

Тема

REST, коды ответов, ошибки, версионирование, OpenAPI.

План содержания

• Ресурсы и действия: где REST помогает, а где мешает
• Коды ответов: чем 400 отличается от 409
• Формат ошибки RFC 7807 и машиночитаемый код правила
• Отображение доменных исключений в ответы
• Идемпотентность запросов на изменение
• Пагинация, фильтрация, сортировка как часть контракта
• Версионирование и обратная совместимость
• OpenAPI как источник правды для приёмочных тестов

Связи

Предшествует лабораторной работе 5. Требования ТЗ, затрагиваемые темой, перечислены в разделе 12 технического задания.