Традиционный vs API-first
- Традиционный: кодируем backend → документируем что получилось → frontend приспосабливается
- API-first: проектируем API → все соглашаются → backend и frontend разрабатываются параллельно
Преимущества
- Frontend может начать работу сразу — mock-сервер генерируется из OpenAPI-схемы
- Проблемы дизайна выявляются до написания кода
- Автоматическая генерация SDK, документации, тестов из контракта
- Проще поддерживать versioning — контракт версионируется в Git
Инструменты
OpenAPI 3.x → Swagger UI (документация), Prism (mock server), OpenAPI Generator (SDK). Stoplight, Postman — для дизайна API.