On: Swagger is now the OpenAPI Specification

[quicklyfrozen]

The spec allows you to describe how you decide to implement these things; it doesn't proscribe any particular API patterns.

You can declare types separately from APIs to make your last two items easier.