Questions about advised use for @ApiResponse

2018-05-21 Thread David Karr
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

2018-05-21 Thread Andrew Kozin
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

2018-05-21 Thread Debbie Martin
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.