Questions about advised use for @ApiResponse
I've been writing REST services for a long time, but I've never used Swagger before, although I've been aware of it. I'm coming into a new project that is using it, although perhaps not as well as it could. I see a bunch of operations that define api responses like this: @ApiResponse(code = 404, message = "Service not available"), @ApiResponse(code = 500, message = "Unexpected Runtime error") These are handled implicitly by the framework. The service implementation doesn't handle them at all. Is it reasonable for services to define these expected response codes when the service implementation itself would never produce them? -- You received this message because you are subscribed to the Google Groups "Swagger" group. To unsubscribe from this group and stop receiving emails from it, send an email to swagger-swaggersocket+unsubscr...@googlegroups.com. For more options, visit https://groups.google.com/d/optout.
Converter OAS2.0 -> OAS3.0 for Ruby
Hi! While working on the OAS tools for request/response generation and validation, I've written a simple loader and converter for OAS2.0/OAS3.0 into OAS3.0 format in Ruby. https://github.com/nepalez/open_api-loader Will be glad to hear any feedback, ideas etc. ) -- You received this message because you are subscribed to the Google Groups "Swagger" group. To unsubscribe from this group and stop receiving emails from it, send an email to swagger-swaggersocket+unsubscr...@googlegroups.com. For more options, visit https://groups.google.com/d/optout.
Trying to import URL
Is Swagger Editor just not able to resolve $ref locations in other files? I've tried both the online and downloaded to my dev workstation. I've tried both import url and import file and the import file does not seem to be able to resolve them at all even when I know the relative path is correct. With import url I get very little useful information, and have tried both with and without the CORS proxy. I'm trying to validate the swagger & external json schemas as I'm aware there are some issues. What am I doing wrong? Here is a sample response { "data": null, "status": -1, "config": { "method": "GET", "transformRequest": [ null ], "transformResponse": [ null ], "url": "https://cors-it.herokuapp.com/?url=http://servername:81/correctpath/dist/swagger.v1.json;, "headers": { "accept": "application/x-yaml,text/yaml,application/json,*/*" } }, "statusText": "" } -- You received this message because you are subscribed to the Google Groups "Swagger" group. To unsubscribe from this group and stop receiving emails from it, send an email to swagger-swaggersocket+unsubscr...@googlegroups.com. For more options, visit https://groups.google.com/d/optout.