Re: Update Codegen Java

2017-11-27 Thread Ron Ratovsky
Which version of the codegen? From: on behalf of Jonas Wolff Reply-To: "swagger-swaggersocket@googlegroups.com" Date: Monday, November 27, 2017 at 10:25 To: Swagger

Re: Hosting a swagger.json file

2017-11-21 Thread Ron Ratovsky
SwaggerHub has a public API that allows you to add/update definitions through it. Take a look at https://app.swaggerhub.com/apis/swagger-hub/registry-api/1.0.45. From: on behalf of Pavlos Kosmetatos Reply-To:

Re: SwaggerUI OpenAPI 3.0 just can't upload a file

2017-11-20 Thread Ron Ratovsky
It’s not supported yet. See https://github.com/swagger-api/swagger-ui/issues/3641. From: on behalf of easyhond Reply-To: "swagger-swaggersocket@googlegroups.com" Date: Monday,

Re: To display multiple variant of reponse for a single 400 status code

2017-11-17 Thread Ron Ratovsky
You can do that with OAS3. From: on behalf of Kumar Abhimanyu Reply-To: "swagger-swaggersocket@googlegroups.com" Date: Friday, November 17, 2017 at 11:54 To: Swagger

Re: how to automate the swagger api services

2017-11-17 Thread Ron Ratovsky
Take a look at https://github.com/SmartBear/swagger-assert4j. From: on behalf of Ciddagoni Ravi Reply-To: "swagger-swaggersocket@googlegroups.com" Date: Friday, November 17,

Re: Adding a multi-item example for an array containing an object renders square brackets twice in Model

2017-11-16 Thread Ron Ratovsky
Please file a ticket with swagger-ui. From: on behalf of PM Reply-To: "swagger-swaggersocket@googlegroups.com" Date: Thursday, November 16, 2017 at 17:25 To: Swagger

Re: how to automate the swagger api services

2017-11-16 Thread Ron Ratovsky
What do you mean by automate the swagger web services? From: on behalf of Ciddagoni Ravi Reply-To: "swagger-swaggersocket@googlegroups.com" Date: Thursday, November 16, 2017 at

Re: How to define abstract property in Model - Swagger

2017-11-15 Thread Ron Ratovsky
Springfox is not one o the libraries we maintain. You’d need to file a ticket with the project to get support. From: on behalf of Gökhan Ayrancıoğlu Reply-To: "swagger-swaggersocket@googlegroups.com"

Re: Create spec from code annotations or in separate YAML file?

2017-11-14 Thread Ron Ratovsky
- not all codegen libraries support the latest version of the OpenAPI 3.0 spec ß none of them currently support OAS3. - not all languages or frameworks have a way to annotate the code The main idea of writing the API definition manually is to control the API design and have it as a

Re: How to define abstract property in Model - Swagger

2017-11-14 Thread Ron Ratovsky
Which library do you use to generate the API definition? From: on behalf of Gökhan Ayrancıoğlu Reply-To: "swagger-swaggersocket@googlegroups.com" Date: Tuesday, November 14, 2017 at

Re: Swagger UI - attempt to "extend" referenced/reused path object with additional parameter

2017-11-10 Thread Ron Ratovsky
JSON References cannot be extended – see https://github.com/OAI/OpenAPI-Specification/blob/master/versions/3.0.0.md#referenceObject. Currently, the editor for 3.0.0 does not show semantic errors, so it’s not covered by it. Technically, it’s not an error, it’s just meaningless (and we show

Re: Best way of displaying more information.

2017-11-10 Thread Ron Ratovsky
You’re confusing the tool with the implementation. It’s like asking the developers of Firefox how to use Facebook. From: on behalf of Rhys Saunders Reply-To: "swagger-swaggersocket@googlegroups.com"

Re: OAS 3.0 - PATH object reference impractical?

2017-11-09 Thread Ron Ratovsky
Out of the three statements, only b) is true. The spec does allow internal references. Your first reference sample is mostly valid, only it needs to be escaped:  $ref: "#/paths/~1request1". You can technically also contain Path Items Objects in an extension and reference those locally.

Re: Swagger 3.0 unable to render example field in parameters?

2017-11-09 Thread Ron Ratovsky
It’s not implemented yet. From: on behalf of Vedant Goenka <19ved...@gmail.com> Reply-To: "swagger-swaggersocket@googlegroups.com" Date: Thursday, November 9, 2017 at 03:38 To: Swagger

Re: Different View of same model

2017-11-08 Thread Ron Ratovsky
er-sw...@googlegroups.com" <swagger-sw...@googlegroups.com> Subject: Re: Different View of same model Thanks for the response Ratovsky! Can you please help me with some more details or provide me any link where I can refer the composition? I am a newbie in swagger. Thanks, Dharmend

Re: Different View of same model

2017-11-08 Thread Ron Ratovsky
I can refer the composition? I am a newbie in swagger. Thanks, Dharmendra On 09-Nov-2017 3:16 AM, "Ron Ratovsky" <r...@swagger.io> wrote: That’s where composition comes in (which works slightly differently depending on which version of the spec you use). From: <swagge

Re: Different View of same model

2017-11-08 Thread Ron Ratovsky
That’s where composition comes in (which works slightly differently depending on which version of the spec you use). From: on behalf of Dharmendra Dubey Reply-To: "swagger-swaggersocket@googlegroups.com"

Re: Group project using Free plan, somehow API's were made as private, now can't access or make public

2017-11-08 Thread Ron Ratovsky
Hi Will, Sorry to hear you’re having problems. I assume you’re talking about SwaggerHub. Assuming you signed up, it automatically started a trial which allows to create private APIs but once the trial is over the access to those APIs is blocked. You should have received a set of emails

Re: Generate client code for API I dont own

2017-11-07 Thread Ron Ratovsky
The codegen needs an OpenAPI definition to generate code for it. It doesn’t matter if it’s your API or someone else’s. From: on behalf of Петър Стоянов Reply-To: "swagger-swaggersocket@googlegroups.com"

Re: understanding "field" and "property" terminology choices in the OpenAPI spec

2017-11-06 Thread Ron Ratovsky
They are interchangeable. We tried to keep the same consistency around the spec, but obviously there’s room for improvement. From: on behalf of "tomj...@gmail.com" Reply-To: "swagger-swaggersocket@googlegroups.com"

Re: OpenAPI security option not being used for Swagger UI 'explore'

2017-11-03 Thread Ron Ratovsky
Not sure what you mean by ‘properly’. From: on behalf of Derek Piper Reply-To: "swagger-swaggersocket@googlegroups.com" Date: Friday, November 3, 2017 at 13:43 To: Swagger

Re: Support for datetimes without timezones

2017-11-03 Thread Ron Ratovsky
The short answer is “not implicitly”. The longer version – the current available formats are the ones defined by JSON Schema and a few additional ones. Starting OAS3 we’re introducing a new concenpt of a format registry, where users could propose and register new formats that would be

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

2017-11-03 Thread Ron Ratovsky
The OpenAPI/Swagger 2.0 specification does not support what you’re trying to describe. OpenAPI 3.0 does. I assume you’re using Springfox for the generation, and I don’t know if they support OAS3 or not – you’d need to check with them. From: on

Re: OpenAPI security option not being used for Swagger UI 'explore'

2017-11-03 Thread Ron Ratovsky
See https://github.com/swagger-api/swagger-ui/issues/2793#issuecomment-335332297. From: on behalf of Derek Piper Reply-To: "swagger-swaggersocket@googlegroups.com" Date: Friday,

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:

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

Re: swagger-scala-module compatibility with OAS 3

2017-10-31 Thread Ron Ratovsky
, 2017 at 09:53 To: "swagger-swaggersocket@googlegroups.com" <swagger-swaggersocket@googlegroups.com> Subject: Re: swagger-scala-module compatibility with OAS 3 Any plans to make swagger-scala-module compatible with swagger-core 2? On Mon, 30 Oct 2017 at 20:16, Ron Ratovsk

Re: Documenting query parameter operators using Swagger

2017-10-31 Thread Ron Ratovsky
This is not a limitation of Swagger but a limitation of OpenAPI as the specification. There’s no work around for it, but you can always submit a feature request to be considered in future versions. From: on behalf of Jay

Re: what's the purpose of the Models section in Swagger UI?

2017-10-31 Thread Ron Ratovsky
The feature request already exists - https://github.com/swagger-api/swagger-ui/issues/2834 From: on behalf of "tomj...@gmail.com" Reply-To: "swagger-swaggersocket@googlegroups.com"

Re: Swagger 3.0.0 editor which support multiple files

2017-10-31 Thread Ron Ratovsky
Hi Rakesh, For more information about Domains and how to reference those as external resources, please refer to the online documentation at https://app.swaggerhub.com/help/domains/index. If you need further assistance with SwaggerHub, please use the online chat (would be an icon to the

Re: Trojan:Win32/Sprisky.U!cl in dowloaded zip

2017-10-30 Thread Ron Ratovsky
We don’t really control the zips – they are produced by GitHub. I seriously doubt there’s any virus there. You can always just clone the git repo as is. From: on behalf of Larry Blair Reply-To:

Re: what's the purpose of the Models section in Swagger UI?

2017-10-30 Thread Ron Ratovsky
Hi Tom, The display of the models at the bottom of Swagger-UI is a result of the merge between the previous versions of Swagger-UI and Swagger-Editor. Swagger-Editor had a models view, and we’ve got numerous requests to have a similar view in Swagger-UI – this is the result. Not

Re: Swagger ignores pattern when creating sample request/response.

2017-10-30 Thread Ron Ratovsky
I don’t understand the question. From: on behalf of Krithika Vittal Reply-To: "swagger-swaggersocket@googlegroups.com" Date: Monday, October 30, 2017 at 12:24 To: Swagger

Re: Swagger 3.0.0 editor which support multiple files

2017-10-30 Thread Ron Ratovsky
We have a product that allows you to do that - https://swaggerhub.com/ From: on behalf of rakesh kumar jha Reply-To: "swagger-swaggersocket@googlegroups.com" Date: Saturday, October

Re: Swagger ignores pattern when creating sample request/response.

2017-10-30 Thread Ron Ratovsky
Follow the template in https://github.com/swagger-api/swagger-ui/issues/new (the details are important). From: on behalf of Krithika Vittal Reply-To: "swagger-swaggersocket@googlegroups.com"

Re: swagger-scala-module compatibility with OAS 3

2017-10-30 Thread Ron Ratovsky
We should change that claim – it does not support swagger-core 2.0.0. From: on behalf of "Javier G. Visiedo" Reply-To: "swagger-swaggersocket@googlegroups.com" Date: Monday,

Re: Swagger ignores pattern when creating sample request/response.

2017-10-30 Thread Ron Ratovsky
We currently don’t take that under consideration when generating sample data. If you’d like to see it change, please file a ticket with the project. From: on behalf of Krithika Vittal Reply-To:

Re: Google app engine and swagger

2017-10-27 Thread Ron Ratovsky
@googlegroups.com" <swagger-swaggersocket@googlegroups.com> Date: Friday, October 27, 2017 at 11:29 To: "swagger-swaggersocket@googlegroups.com" <swagger-swaggersocket@googlegroups.com> Subject: Re: Google app engine and swagger Iam trying to integrate swagger UI On

Re: Google app engine and swagger

2017-10-27 Thread Ron Ratovsky
Swagger is a collection of tools, which one are you referring to? From: on behalf of Bhuvana Reply-To: "swagger-swaggersocket@googlegroups.com" Date: Thursday, October 26,

Re: How do you turn Swagger-UI validation off

2017-10-26 Thread Ron Ratovsky
Not in the near future. From: on behalf of "ulso.senn...@gmail.com" Reply-To: "swagger-swaggersocket@googlegroups.com" Date: Thursday, October 26, 2017 at 13:00 To: Swagger

Re: Can't override servers url in path object

2017-10-25 Thread Ron Ratovsky
Thanks Tom! From: on behalf of "tomj...@gmail.com" Reply-To: "swagger-swaggersocket@googlegroups.com" Date: Wednesday, October 25, 2017 at 13:19 To: Swagger

Re: Can't override servers url in path object

2017-10-25 Thread Ron Ratovsky
Hi Tom, This looks like a bug. Mind filing a ticket on swagger-ui about it? (this is a UI issue, not editor). Thanks, Ron From: on behalf of "tomj...@gmail.com" Reply-To: "swagger-swaggersocket@googlegroups.com"

Re: Swagger Core 2.0.0-rc2 with RESTEasy 3.x example

2017-10-25 Thread Ron Ratovsky
Did you get a chance to take a look at the sample in https://github.com/swagger-api/swagger-samples/tree/2.0/java/java-jersey2? From: on behalf of Mathis Møller Reply-To: "swagger-swaggersocket@googlegroups.com"

Re: Swagger Core 2.0.0-rc2 with RESTEasy 3.x example

2017-10-25 Thread Ron Ratovsky
We currently don’t have examples for RESTEasy, but we do for Jersey. It should be simple enough to follow a similar route in RESTEasy. From: on behalf of Mathis Møller Reply-To: "swagger-swaggersocket@googlegroups.com"

Re: How to suppress Errors in swagger

2017-10-25 Thread Ron Ratovsky
`double` is not a valid type, so you can’t use it. If you want to simulate `double`, take a look at https://github.com/OAI/OpenAPI-Specification/blob/master/versions/2.0.md#data-types. From: on behalf of Vasiliy

Re: OpneAPI 3.0 Documentation Generation

2017-10-23 Thread Ron Ratovsky
Yup. There could be tools out there that are not developed by us that can render OAS3 in a simple HTML, but I don’t know of anything specific. From: on behalf of Aidon Reply-To: "swagger-swaggersocket@googlegroups.com"

Re: OpneAPI 3.0 Documentation Generation

2017-10-23 Thread Ron Ratovsky
Check the browser’s console for any errors. From: on behalf of Aidon Reply-To: "swagger-swaggersocket@googlegroups.com" Date: Monday, October 23, 2017 at 13:40 To: Swagger

Re: OpneAPI 3.0 Documentation Generation

2017-10-23 Thread Ron Ratovsky
at I try. Cheers, Aidon. On Mon, Oct 23, 2017 at 9:45 AM, Ron Ratovsky <r...@swagger.io> wrote: Hi Aidon, The codegen doesn’t support OAS3 yet. The editor simply uses Swagger-UI to render the definitions, you can use that directly. From: <swagger-swaggersocket@

Re: OpneAPI 3.0 Documentation Generation

2017-10-23 Thread Ron Ratovsky
Hi Aidon, The codegen doesn’t support OAS3 yet. The editor simply uses Swagger-UI to render the definitions, you can use that directly. From: on behalf of Aidon Reply-To: "swagger-swaggersocket@googlegroups.com"

Re: Fetching resource list, Please wait

2017-10-19 Thread Ron Ratovsky
That’s a question to Swashbuckle… From: on behalf of Andy Philpotts Reply-To: "swagger-swaggersocket@googlegroups.com" Date: Thursday, October 19, 2017 at 12:03 To: Swagger

Re: Fetching resource list, Please wait

2017-10-19 Thread Ron Ratovsky
Actually no. The only place `null` is a valid value is as a value of extension. Having it anywhere else in the definition is invalid and will break tooling. From: on behalf of Andy Philpotts Reply-To:

Re: Fetching resource list, Please wait

2017-10-19 Thread Ron Ratovsky
That doesn’t look good at all. `null` is not a valid value, and that’s a partial JSON. From: on behalf of Andy Philpotts Reply-To: "swagger-swaggersocket@googlegroups.com" Date:

Re: Various Swagger 1.5.16 issues with JAXB, Jersey 1.x/2.x and Swagger-UI 2.x and 3.x

2017-10-19 Thread Ron Ratovsky
Thanks for the elaborate investigation. Since there’s a ticket opened for the second issue you mentioned, would you mind opening one for the first issue? From: on behalf of Michael Günnewig Reply-To:

Re: swagger + java rest repositores

2017-10-19 Thread Ron Ratovsky
Hi Eitan, the question isn’t very clear. Can you clarify what you mean? From: on behalf of Eitan Herman Reply-To: "swagger-swaggersocket@googlegroups.com" Date: Thursday, October

Re: OpenApi 3 & latest swagger-ui

2017-10-17 Thread Ron Ratovsky
It should support cookies. If you experience something else, please file a ticket on the project, providing the details requested in the issue template. From: on behalf of Julien Sié Reply-To:

Re: OpenAPI reuse part of definition without defining a new one

2017-10-17 Thread Ron Ratovsky
You can’t. JSON Schema doesn’t allow you to pick fields out of a definition. You can define the smaller instance, and make the bigger one an extension of the smaller one to avoid repetition. From: on behalf of Gabriele Proietti Mattia

Re: How to use oneOff, anyOff

2017-10-17 Thread Ron Ratovsky
OpenAPI doesn’t allow you to define interdependencies between parameters. From: on behalf of Lavin Motwani Reply-To: "swagger-swaggersocket@googlegroups.com" Date: Monday,

Re: Annoying animation on OS

2017-10-16 Thread Ron Ratovsky
Which browser + version do you use? From: on behalf of Alexander Volkov Reply-To: "swagger-swaggersocket@googlegroups.com" Date: Saturday, October 14, 2017 at 10:06 To: Swagger

Re: Generate Clients with OpenAPI 3.0

2017-10-16 Thread Ron Ratovsky
We’re working on it, but it’ll take some time. From: on behalf of Stefan Walter Reply-To: "swagger-swaggersocket@googlegroups.com" Date: Sunday, October 15, 2017 at 22:20 To: Swagger

Re: Swagger UI for REST Request body example

2017-10-13 Thread Ron Ratovsky
It’s not implemented in the UI yet. You can file a ticket with the project. From: on behalf of Provash Dowari Reply-To: "swagger-swaggersocket@googlegroups.com" Date: Friday,

Re: Swagger integration with mysql db for log collection

2017-10-13 Thread Ron Ratovsky
Not really sure which tools you’re referring to. From: on behalf of "jaychandransubraman...@gmail.com" Reply-To: "swagger-swaggersocket@googlegroups.com" Date: Friday,

Re: Seems like a BUG in swagger js codegen

2017-10-13 Thread Ron Ratovsky
Please file a ticket on the project. From: on behalf of vijay kumar Reply-To: "swagger-swaggersocket@googlegroups.com" Date: Friday, October 13, 2017 at 07:02 To: Swagger

Re: Swagger Dropwizard Authentication

2017-10-09 Thread Ron Ratovsky
You can hide any generated parameter by adding the @ApiParam(hidden=true) annotation. From: on behalf of Piyush Mendhiratta Reply-To: "swagger-swaggersocket@googlegroups.com"

Re: Error in generated code (Java JAX-RS, serverside) for extended models

2017-10-09 Thread Ron Ratovsky
Please file a ticket directly on the project. From: 'Philipp' via Swagger Reply-To: "swagger-swaggersocket@googlegroups.com" Date: Monday, October 9, 2017 at 01:07 To: Swagger

Re: I can't seem to get the model to structure the output properly..

2017-10-05 Thread Ron Ratovsky
, 2017 at 16:43 To: "swagger-swaggersocket@googlegroups.com" <swagger-swaggersocket@googlegroups.com> Subject: Re: I can't seem to get the model to structure the output properly.. I have clicked the button if that's what you mean On Oct 5, 2017 5:40 PM, "Ron Ratovsky" <r.

Re: I can't seem to get the model to structure the output properly..

2017-10-05 Thread Ron Ratovsky
The UI generates a sample response, it doesn’t show you the actual response unless you execute the call. From: on behalf of xhorntail Reply-To: "swagger-swaggersocket@googlegroups.com"

Re: I can't seem to get the model to structure the output properly..

2017-10-05 Thread Ron Ratovsky
Replace your schema with:   schema:     type: object     properties:   user_agents:     type: array     items:   type: object   properties:     user_agent_id:  

Re: I can't seem to get the model to structure the output properly..

2017-10-05 Thread Ron Ratovsky
You’re only describing the inner array. You need to describe the encompassing object, the one containing the “user_agents” property. From: on behalf of xhorntail Reply-To: "swagger-swaggersocket@googlegroups.com"

Re: Open yaml file directly on editor.swagger.io

2017-10-05 Thread Ron Ratovsky
Basically, the configurations that are available in swagger-ui, are available in swagger-editor. It will only work with hosted files. From: on behalf of Tijs G Reply-To: "swagger-swaggersocket@googlegroups.com"

Re: array of objects help

2017-10-04 Thread Ron Ratovsky
Swagger-ui will currently not display that, no matter how you define it. From: on behalf of Nathaniel Graham Reply-To: "swagger-swaggersocket@googlegroups.com" Date: Wednesday,

Re: How to hide API docs for different vendors?

2017-10-04 Thread Ron Ratovsky
Assuming you’re using Swashbuckle, you’d need to file a ticket on the project to get an answer. From: on behalf of Pankaj Joshi Reply-To: "swagger-swaggersocket@googlegroups.com"

Re: Open yaml file directly on editor.swagger.io

2017-10-04 Thread Ron Ratovsky
Yup - http://editor.swagger.io?url=yaml_url.yaml From: on behalf of Tijs G Reply-To: "swagger-swaggersocket@googlegroups.com" Date: Wednesday, October 4, 2017 at 00:05 To: Swagger

Re: array of objects help

2017-10-04 Thread Ron Ratovsky
The information is still not clear to me. Can you provide more details? From: on behalf of Nathaniel Graham Reply-To: "swagger-swaggersocket@googlegroups.com" Date: Tuesday, October

Re: Swagger (2.0) spec - response is zip with 1 JSON file inside - how to add JSON structure spec

2017-10-03 Thread Ron Ratovsky
I’m afraid there’s no way to describe that. If you want to see support for this in the future, try filing a ticket at https://github.com/OAI/OpenAPI-Specification. From: on behalf of Ergya Russty Reply-To:

Re: Keycloak (OpenID-Connect OAuth) Swagger Integration

2017-10-03 Thread Ron Ratovsky
Same computer is not enough – they have to be hosted on the same server and the same port (i.e., the same application/service). Only browsers are affected by CORS, which is why curl works as expected. Try fixing that first, then we can check for other issues. From:

Re: RequestBody parameter annotation problem - swagger 2.0.0-RC1

2017-10-02 Thread Ron Ratovsky
Can you file a ticket on the project with the details below? From: on behalf of Chris Olson Reply-To: "swagger-swaggersocket@googlegroups.com" Date: Monday, October 2, 2017 at 16:51

Re: Keycloak (OpenID-Connect OAuth) Swagger Integration

2017-10-02 Thread Ron Ratovsky
You need to enable CORS in Keycloak as it seems. A quick google search came up with https://github.com/keycloak/keycloak/tree/master/examples/cors but there might be other more suitable resources. From: on behalf of Néstor Almeida

Re: In Response Media Type

2017-10-02 Thread Ron Ratovsky
That link is talking about OAS3. If you’re getting that error, you’re most likely defining a Swagger 2.0 definition which doesn’t support that construct. From: on behalf of Lavin Motwani Reply-To:

Re: How do I use swagger api to generate swagger with additionalProperties as false for object

2017-09-28 Thread Ron Ratovsky
I know. I’m embarrassed to say that that’s my mistake too ☹ Regardless, it’s not going to change in the Swagger-provided tools. From: on behalf of Ben Sayers Reply-To: "swagger-swaggersocket@googlegroups.com"

Re: How do I use swagger api to generate swagger with additionalProperties as false for object

2017-09-28 Thread Ron Ratovsky
Ben, I realize this is might sound a bit arrogant, but that’s not the intent. Being the person who wrote the Swagger 2 specification, and spent hours specifically on the Schema Object itself, I can assure you that the intent was as I stated before. This is a mistake in the wording of the

Re: How do I use swagger api to generate swagger with additionalProperties as false for object

2017-09-28 Thread Ron Ratovsky
Yes, the 3.0.0 spec was changed to allow that. I’m not sure if we support it yet in swagger-core 2.0. Mind filing a ticket? From: on behalf of Yuting Reply-To: "swagger-swaggersocket@googlegroups.com"

Re: How to reference the JSON schemas of objects from external sources (eg.GIT) into openapi yaml?

2017-09-28 Thread Ron Ratovsky
JSON References allow you to reference any http url. This is not about additional documentation, this is about using $ref to reference those. Keep in mind that if you’re using full JSON Schema, you won’t be able to reuse those in your Swagger definition as the specification does not support

Re: How do I use swagger api to generate swagger with additionalProperties as false for object

2017-09-28 Thread Ron Ratovsky
The 2.0 specification doesn’t allow setting additionalProperties: false. It was intended to be the default definition but was never clarified in the spec. From: on behalf of Yuting Reply-To:

Re: Syntax error in Swagger Editor

2017-09-27 Thread Ron Ratovsky
Path parameters must always be required. Add: required: true to the parameter definition and the errors would disappear. From: on behalf of Ian G Reply-To: "swagger-swaggersocket@googlegroups.com"

Re: swagger-ui missing index.html in dist

2017-09-27 Thread Ron Ratovsky
That’s why there are two separate modules. We recently added more details about it in the project’s README, have a look at https://github.com/swagger-api/swagger-ui. From: on behalf of Jack Wang Reply-To:

Re: saving JSON files

2017-09-27 Thread Ron Ratovsky
The location is controlled by your browser. Simply click Download JSON from the File menu. From: on behalf of Jerry Pope Reply-To: "swagger-swaggersocket@googlegroups.com" Date:

Re: OpenAPI Specification (FKA Swagger Spec 3.0) is under development

2017-09-27 Thread Ron Ratovsky
Hi Kay, I don’t have a concrete ETA for a final release of swagger-core, but OAS3 support is our main focus right now. As for swagger-ui, server variables are already supported in the current version. Give it a try and see how it works. From: 'Kay J' via Swagger

Re: How to implement jackson multi polymorphism using Swagger

2017-09-27 Thread Ron Ratovsky
Take a look at https://github.com/OAI/OpenAPI-Specification/blob/master/versions/2.0.md#composition-and-inheritance-polymorphism. From: on behalf of Sourav Bhattacharjee Reply-To: "swagger-swaggersocket@googlegroups.com"

Re: How to apply header in api documentation

2017-09-27 Thread Ron Ratovsky
I assume you use Swashbuckle which is a community project – we’re unable to provide support to it. Please file a ticket with the project directly. From: on behalf of RAJAN KUMAR Reply-To:

Re: Misspelling on the off site

2017-09-27 Thread Ron Ratovsky
Thanks for reporting, should be fixed now. From: on behalf of "nicolay.chi...@gmail.com" Reply-To: "swagger-swaggersocket@googlegroups.com" Date: Monday, September 25, 2017 at

Re: How to reference the JSON schemas of objects from external sources (eg.GIT) into openapi yaml?

2017-09-27 Thread Ron Ratovsky
It looks like gitlab gives you raw html links to files, so you can use that. From: on behalf of Raghu Meda Reply-To: "swagger-swaggersocket@googlegroups.com" Date: Tuesday,

Re: i.s.inflector.schema.SchemaValidator - unhandled token type VALUE_EMBEDDED_OBJECT

2017-09-27 Thread Ron Ratovsky
Please file a ticket on swagger-inflector and we’ll take it from there. From: on behalf of msuh Reply-To: "swagger-swaggersocket@googlegroups.com" Date: Tuesday, September 26, 2017 at

Re: Is there some advice for version location? for example in path or basepath

2017-09-27 Thread Ron Ratovsky
If you’re asking about general API versioning, I’d suggest looking up online resources about the topic as there are numerous solutions and It’s up to you to decide which one works best for your case. If this is the current design and it’s the prefix to all your API calls, it better live in

Re: Externally defined XML Schema

2017-09-27 Thread Ron Ratovsky
Hi Ben, As you said, right now the only way to describe schemas is with JSON Schema, and we’ve added some extensions to help with XML modeling. The solution would be to convert the XSDs to JSON Schema with the use of those special extensions. That said, not all XSDs can be converted and not

Re: Any tools for generating a web form out of a model in the swagger spec?

2017-09-18 Thread Ron Ratovsky
will render form fields, one for each field in the model, taking into account the type of each model field to provide the proper form field. -Renier On Sep 15, 2017, at 5:53 AM, Ron Ratovsky <r...@swagger.io> wrote: https://github.com/swagger-api/swagger-ui ? From:

Re: How to create a Swagger *.yaml or *.json definition file and project settings?

2017-09-18 Thread Ron Ratovsky
It looks like there might be something corrupt with the apidocs file itself. Are you able to share it? From: on behalf of Vigfus A Reply-To: "swagger-swaggersocket@googlegroups.com"

Re: How to create a Swagger *.yaml or *.json definition file and project settings?

2017-09-18 Thread Ron Ratovsky
No, unfortunately that’s not it. It is most likely a file called ‘swagger.json’ or simply ‘apidocs’. From: on behalf of Vigfus A Reply-To: "swagger-swaggersocket@googlegroups.com"

Re: Authorization in the openAPI 3.0

2017-09-18 Thread Ron Ratovsky
It’s not yet supported. See: https://github.com/swagger-api/swagger-ui/issues/3641 https://github.com/swagger-api/swagger-ui/issues/3665 From: on behalf of "maskalchuk.aliaksa...@gmail.com" Reply-To:

Re: Schema error

2017-09-18 Thread Ron Ratovsky
YAML is sensitive to indentation. >From what you shared it seems like a lot is misplaced or poorly indented. The error actually tells you which keywords cannot exist under the root, hinting you what’s not indented properly. Another point – paths must begin with a ‘/’. From:

Re: How to create a Swagger *.yaml or *.json definition file and project settings?

2017-09-15 Thread Ron Ratovsky
Great, we’re making progress. “Swagger” is the name of a set of open source project around the OpenAPI specification. If you want to compare it to the SOAP days, the OpenAPI is to REST what WSDL is to SOAP. The screenshot you’re sharing is from swagger-ui, one of our tools. That takes

<    1   2   3   4   5   6   >