desktop icon indicating copy to clipboard operation
desktop copied to clipboard

JSON Schemas/Samples separate from Swagger

Open jayshao opened this issue 7 years ago • 4 comments

It would be nice for JSON schemas to be first class citizens - e.g. editable as separate documents - and includable in hubs with a renderer and samples

The particular case driving this is wanting to re-use JSON schemas across REST APIs, log messages, messages placed on Kinesis queues, and other areas - but share models, validations, and examples regardless of channel

jayshao avatar Nov 28 '17 00:11 jayshao

Note: in particular in this use-case - it would be nice to simplify importing of JSON schemas that already exist - and so already have '#/definitions' references - similar to the Swagger import

One example of a file like this is: https://raw.githubusercontent.com/Intersection/openrtb2x/2.0/openrtb-validator/src/main/resources/schemas/openrtb-schema_bid-request_v2-4.json

jayshao avatar Nov 29 '17 17:11 jayshao

We've had several requests for this, and will get to it next week :).

marbemac avatar Nov 30 '17 17:11 marbemac

Need to wait on the new editor file tree explorer, because introducing this file type adds many more files to the file tree than the current UX is meant to handle effectively.

marbemac avatar Dec 18 '17 17:12 marbemac

Wondering if this is still in the works

jayshao avatar Dec 03 '18 22:12 jayshao