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
Labels
enhancement
New feature or request
Milestone
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
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
Describe the solution you'd like
Describe alternatives you've considered
Additional context
The text was updated successfully, but these errors were encountered: