That is a pretty open ended question, so I would take the liberty of suggesting two basic architectural principles while you go about any new development henceforth:
- Whenever a new development request comes in, we need to check for two things:
1. What functionality of this overall block of development is already present elsewhere in my ecosystem?
2. Will it be feasible to create this new function as a separate microservice\API? Feasibility should be determined based on long term architecture vision, size and impact of the functionality, development costs - benefits etc.
I hope your question was about APIs in general and not OpenAPI implementation in particular.
------------------------------
Janit Vora
Tata Consultancy Services
------------------------------