Ask a Question

swagger and openApi extented notations "x-"

0 Kudos

swagger and openApi extented notations "x-"

It s possible to extend the fixed fields in a schema. The specification indicate that we just need to prefix the extra fields with "x-". It s a good point if we want to specified spécific informations - per example the data source of a field.

But, in the produced documentations, at the end, we never see this extra fields.

My suggestion is, optionnaly, we can add/display this extra fields in the final documentation.


Currently, this is what we have :

Example - No extra field displayedExample - No extra field displayed

We can expect that we can see the extra field x-dataSource in the documentation.

SmartBear Alumni (Retired)
Status changed to: New Idea

This is now implements and showExtensions and showCommonExtensions are now enabled in SwaggerHub

Status changed to: Implemented
Welcome to the SwaggerHub Feature Requests board!

Here you can review already submitted feature requests and vote up the ones you like! If you can't find the feature you want - go ahead and suggest your own idea. Ideas with the highest rating can be implemented in the product.

Check out the Create a Feature Request guide for more information.
New Here?
Welcome to the Community
Sign Up Here