Традиційний 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.