Hello everyone, I am very new to swagger and also new to editing a Yaml file.
I am trying to show on my documentation basically a simple text box which appears and in that I want to show a json text example so the user who uses the documentation can actually see the json text.
I have used x-example and it doesn't look proessional and also the text "x-example" appears. So I am trying to find a more efficient way and something that looks better.
What i would like is basically something similar to how we call a definition by putting $ref: '#/definitions/definationname under schema and a textbox/terminal/command line kind of window appears showing the content, I want to do something similar where i can call some json file's content to appear or if thats not a possibility, I want to find a way where I can simply paste paste my json example in a text box for users to see under body which can replace my x-example.
I would really appreciate if someone can help me with this please.
and this is the screenshot displaying the body which is calling a definiation.
if i want to avoid the whole definiition proces and simply just paste small json file content there in the body, how do I go ahead and do that instead of bringing schema etc. Can i simply add an example with a text box showing my text(json content).
All i am trying to achieve is just add few simple examples.
In one example i want to show curl command which I want the users to try(not the one which appears in try it now), in other example I want to just show json text.
Whats the best strategy to edit my yaml and make this happen.