This repository was archived by the owner on Dec 25, 2024. It is now read-only.
This repository was archived by the owner on Dec 25, 2024. It is now read-only.
[REQ] restructure endpoint data to allow components/X imports #34
Closed
Description
Is your feature request related to a problem? Please describe.
Header + Response
parameters have schema or content.mediaType.schema
And parameter names must be unique for (location + name)
So one needs a form like:
Only request and response bodies use contenttype for ParamNameOrContentType
{Request/ResponseFor{status}}{Query/Cookie/Header/Path/Body}{{ParamNameOrContentType}}Schema
- RequestQueryStatusSchema
- RequestBodyApplicationJsonSchema
- ResponseFor200HeaderStatusSchema
Without this, schemas could collide
Another solution is to make the parent instances into classes, and have the schema definitions inline
That is more complicated
The more complicated solution is preferred because one should be able to$ref shared definition components that define RequestBodies/Parameters/Responses/Headers
This restructuring will also allow schemas to be inherited from PathItem parameters