Going directly to a microservices architecture is risky, so consider building a monolithic system first. Split to microservices when, and if, you need it.| martinfowler.com
The OpenAPI Specification defines a standard interface to RESTful APIs which allows both humans and computers to understand service capabilities without access to source code, documentation, or network traffic inspection.| swagger.io
