openapifirst
Open API-first
OpenAPI-first (alebo contract-first) je spôsob vývoja API, pri ktorom sa najskôr navrhne API špecifikácia v OpenAPI Specification a až potom sa implementuje server aj klient.To má eliminovať nevýhody: nedopracovaná dokumentácia voči existujúcemu kódu, zaostávanie API frontend-u, nekompatibilita.
Poradie vývoja:
- návrh API - špecisfikácia a schválenie
- OpenAPI dokument
- implementácia servera - generovanie server skeleton-u
- generovanie klientov
Konečné výhody:
- API je jasne definované
- server a klient sú synchronizované
- dokumentácia je automatická
Praktický postup
260304 na článku sa pracuje…
openapifirst.txt · Posledná úprava: od attilajancik