Skip to content
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
@spacether

Description

@spacether

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

Describe the solution you'd like

Describe alternatives you've considered

Additional context

Metadata

Metadata

Assignees

No one assigned

    Labels

    enhancementNew feature or request

    Type

    No type

    Projects

    No projects

    Milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions