Some existing hypermedia formats (such as JSON API, HAL, JSON Collection) define a standard 'wrapper' for responses (not unlike the old SOAP envelope, in some ways).
Current OpenAPI conventions are inconvenient and very redundant in describing these formats. An OpenAPI method of describing APIs with these formats would produce specs that are much DRYer.
#136
#519
#522
#476
Solutions are not described here yet, but this should serve as a point to consolidate concepts from prior feedback when evaluating potential solutions.
@darrelmiller input here would be great.
Some existing hypermedia formats (such as JSON API, HAL, JSON Collection) define a standard 'wrapper' for responses (not unlike the old SOAP envelope, in some ways).
Current OpenAPI conventions are inconvenient and very redundant in describing these formats. An OpenAPI method of describing APIs with these formats would produce specs that are much DRYer.
#136
#519
#522
#476
Solutions are not described here yet, but this should serve as a point to consolidate concepts from prior feedback when evaluating potential solutions.
@darrelmiller input here would be great.