API Versioning with multiple same request paths with different Accept media content

2017-11-01 Thread Peraiah Karnam
Hi team, This is Karnam, working as Sr.Java Dev in reputed company. Had faced the problem with API Versioning with multiple same request paths with different Accept media content, right now i am using spring boot with swagger 2.0, the dependencies i am using are springfox-swagger and ui with 2.

Support for datetimes without timezones

2017-11-01 Thread Julien Silland
Hello all, My team is in the process of retrofitting a Swagger/OpenAPI specification onto a relatively large API. One of the peculiarities of a given endpoint is that it accepts and returns a model containing datetimes but without the timezone, which is inferred on the server side using a locat

Documentation for existing endpoints

2017-11-01 Thread Antofie Rares
Hello, I'm working on a Spring Boot application and I would like to implement Swagger for documenting the REST Services. Is there any way around to add custom description without changing the controllers code (for example adding @Api annotation). Can the endpoints be documented through a .prope

Re: OAS 3 | custom response code

2017-11-01 Thread Ron Ratovsky
Custom HTTP codes are not supported by the specification itself. They weren’t supported before either, even if the tools didn’t complain about it. See https://github.com/OAI/OpenAPI-Specification/blob/master/versions/3.0.0.md#responsesObject. From: on behalf of "diconiumhaert...@g

OAS 3 | custom response code

2017-11-01 Thread diconiumhaertale
Hello, in our project we introduced custom response code (HTTP status codes) like 901. In OAS 3 it seems like only the status groups 1xx, 2xx, 3xx, 4xx and 5xx are supported. When I try to document the response code in Swagger Editor I get the following error message: Schema error at paths['/

Re: Swagger 3.0.0 editor which support multiple files

2017-11-01 Thread Ron Ratovsky
The master version of swagger-editor already supports OAS3. From: on behalf of Hung Nguyen Reply-To: "swagger-swaggersocket@googlegroups.com" Date: Tuesday, October 31, 2017 at 21:55 To: Swagger Subject: Re: Swagger 3.0.0 editor which support multiple files Hi Ron, I check out