Backend říká „API hotové”, frontend zjistí jiný response formát, QA testuje proti zastaralé dokumentaci. API-first development tohle řeší.
Specifikace jako artefakt¶
Nejdřív OpenAPI specifikace, pak implementace. Generujeme server stuby (Spring), TypeScript klienty, dokumentaci (Redoc) a mock server (Prism). Frontend pracuje okamžitě proti mocku.
Contract testing¶
Schemathesis pro property-based testing — generuje requesty ze specifikace a ověřuje backend response. Odhalil edge case bugy, které by manuální testy nenašly. Breaking changes blokují merge.
Výsledky¶
- API mismatch bugy: -90 %
- Paralelní vývoj = rychlejší delivery
- Dokumentace vždy aktuální
API-first = méně bugů, rychlejší vývoj¶
Investice do specifikace na začátku se vrátí mnohonásobně.
openapiapirestswaggercontract testing