One way to avoid API chaos is to use higher level tooling that supports, for example, model driven development (MDD). To be able to define a service at the domain level as how it acts of business objects in the library. Let tooling create the XSD and swagger documents. The result would be much more consistent API documentation and to some extent, behaviors.
This task is to look at the various options to come up a level, away from the schema, when defining APIs.
One way to avoid API chaos is to use higher level tooling that supports, for example, model driven development (MDD). To be able to define a service at the domain level as how it acts of business objects in the library. Let tooling create the XSD and swagger documents. The result would be much more consistent API documentation and to some extent, behaviors. This task is to look at the various options to come up a level, away from the schema, when defining APIs.
Links: https://supermodel.io/#learn-more https://opentravel.org/download-otm-tool/