Forum Discussion

Musaffir's avatar
Musaffir
Contributor
8 years ago

REST API Document Generation with SoapUI

Hello,

 

This may sound like a weird question , but I wanted to give it a try

 

I started using soapUI some time back and already made a relatively bigger project with various REST API resource end points,and generated Test suites etc.

 

And now I am thinking to have an option to make a interactive decent documentation for all those REST API endpoints , so any testers or business people can simply go through it and under stand a bit better on what are the API resources available and what does they do et cetera..

 

Do we have any workaround or logic available to achieve this relatively easily with the existing soapUI project that I have ?

 

I have heard we have {{Swagger}} from Smartbear which is extensively for all the API documentation purpose , but do we have option to mix up the Swagger and existing soapUI project to achieve documentation relatively a little easier .

 

Any idea in general on API documentation , or in the above direction would help me 

 

Thanks in Advance !

 

 

Regards

Musaffir

 

 

  • HKosova's avatar
    HKosova
    8 years ago

    SoapUI 5.2+ includes the Swagger plugin that lets you export your project to a Swagger spec in the JSON or YAML format. You can then use Swagger UI to render the Swagger spec as interactive API docs - check out the demo at petstore.swagger.io.

     

    If you are interested in using Swagger for API documentation and/or API developent, also check out SwaggerHub - it's our cloud hosting for API specs, combined with collaboration features, versioning, privacy control, mock server, client/server generators, and integrations. A free plan is available.

  • HKosova's avatar
    HKosova
    SmartBear Alumni (Retired)
    8 years ago

    SoapUI 5.2+ includes the Swagger plugin that lets you export your project to a Swagger spec in the JSON or YAML format. You can then use Swagger UI to render the Swagger spec as interactive API docs - check out the demo at petstore.swagger.io.

     

    If you are interested in using Swagger for API documentation and/or API developent, also check out SwaggerHub - it's our cloud hosting for API specs, combined with collaboration features, versioning, privacy control, mock server, client/server generators, and integrations. A free plan is available.

    • Musaffir's avatar
      Musaffir
      Contributor
      8 years ago

      Thank you Helen for the reply.

       

      As I am on the open source version of SoapUI , I downloaded the swagger plugin and made it available to SoapUI explicitly.

      I could see the 'Export swagger' option from the context of project in soapUI and I am able to export to json format as well.

       

      But it seems not giving a nice out put as i expected when I parsed it with the Swagger UI.

       

      My project has all a single rest api service having different resources end points.

       

      And in the same project I have generated Test suites as well, so the project xml file it self is a huge one, will this cause a problem like what I am experiencing now ?

       

      I was expecting I can simply export the spec file from my soapui project and pass it to swagger UI to get the documentation , instead of writing all the spec by hand :)

       

       

       

      Warm Regards

      Musaffir