Forum Discussion
Have you included examples in your schemas ? If include this and the auto mocking is enabled then they will see those responses in the "try it out" and the example sections on the docs. See this post https://community.smartbear.com/t5/SwaggerHub/What-is-benefit-of-virtserver-swaggerhub-com-GET/m-p/199886#M1062
If you want to make customer facing docs have you tried Re-doc? that is able to take a OAS def and make a pretty good looking static docs site from it.
HI,
Yes I have an examples, I made some.
But currently, I have to document 20+ endpoints, that are working, so I can get an example of response by calling them directly. So that would save time on organizing response, then copying. That would be non error prone, also time consuming.
So I want to call existing API and simply save response.
Is it possible with swagger?
- alex-savage4 years agoOccasional Contributor
SwaggerInspector (https://inspector.swagger.io/) will let you call an existing API, save the responses to move them into an OAS definition. Give it a try with your or a simple API and see how you get on.
- madcatzx4 years agoOccasional Contributor
I know this in theory, as title of this post is saying: Integration between Hub and Inspector.
Is there any tutorial or some documentation on this exact thing?
Because I couldn't manage to save response with inspector and import it back to Swagger HUB.
- alex-savage4 years agoOccasional Contributor
Only guide I have ever seen was the one I posted in the first reply: https://swagger.io/blog/api-development/how-to-perform-a-basic-api-test/ has a nice video too. Hope that can help you
Related Content
Recent Discussions
- 10 days agokj20nt