4

Please provide a Swagger, OpenAPI or WADL file to describe your API

Please provide a Swagger, OpenAPI or WADL file to describe your API.

 

You have an API that makes automation of tasks possible.  That's Great!

 

Setting up the API resources, methods, default requests and the headers, parameters, etc. that are needed to test against the API in SoapUI or Postman is a manual and time-consuming process.  That's NOT Great! 

 

If you could provide us with a Swagger (i.e. openAPI 2.0) or WADL file we could import all of that into SoapUI or Postman and be up and running in minutes.  Swagger/OpenAPI can also be used to generate your API documentation... which would make it much easier to navigate your API capabilities without having to search for specific items in your support site.

3 comments

  • Avatar
    Karen Cann Official comment

    Excellent suggestions! We're currently investigating when we might be able to provide Swagger-type files. Meanwhile, we'll restructure the support site API documentation to make it easier to use.

  • 0
    Avatar
    Richard Granaman

    This would be super useful for me as well.

  • 0
    Avatar
    David Finch

    That would have been really useful to us too!

Please sign in to leave a comment.