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

2017-09-27 Thread Chang Zhiyuan
Thanks Ron. 在 2017年9月28日星期四 UTC+8上午2:19:01,Ron写道: > > 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 desig

Re: saving JSON files

2017-09-27 Thread Jerry Pope
My gawd, why couldn't I see that! So simple. Thanks Ron :-) On Wednesday, September 27, 2017 at 11:58:23 AM UTC-7, Ron wrote: > > The location is controlled by your browser. Simply click Download JSON > from the File menu. > > > > > > > -- You received this message because you are subscrib

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" Date: Wednesday, September 20, 2017 at 18:29 To: Swagger Subject: Syntax error in Sw

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: "swagger-swaggersocket@googlegroups.com" Date: Friday, September 22, 2017 at

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: Wednesday, September 27, 2017 at 11:54 To: Swagger Subject: saving JSON files when using Swagger Edi

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 Reply-To: "swag

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" Date: Monday, September 25, 2017 at 02:52 To: Swagger Subject

saving JSON files

2017-09-27 Thread Jerry Pope
when using Swagger Editor, how do I save the JSON to a particular file / location? I'm very new to and quite naive about this tool. Thanks for any guidance you can provide. Jerry -- You received this message because you are subscribed to the Google Groups "Swagger" group. To unsubscribe from

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: "swagger-swaggersocket@googlegroups.com" Date: Monday, September 25, 2017 at 06:29 To: Swagger

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 08:56 To: Swagger Subject: Misspelling on the off site Hi all! Developers or designers, open please ht

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, September 26, 2017 at 07:24 To: Swagger Subject: How to reference the JSON schemas of objects from external so

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 17:16 To: Swagger Subject: i.s.inflector.schema.SchemaValidator - unhandled token type VALUE_EMBED

Re: Generate Swagger documentation during Runtime in J2SE legacy application

2017-09-27 Thread 'Karishma Dalal' via Swagger
I see, thanks for the suggestion. I will give Springfox a try and see how far I can go! Thanks, Karishma On Wed, Sep 27, 2017 at 11:42 AM, Ron Ratovsky wrote: > Fir a spring-based API check out https://github.com/springfox/springfox/. > > I’m not familiar enough with XMLBeans to tell you if it

Re: Generate Swagger documentation during Runtime in J2SE legacy application

2017-09-27 Thread Ron Ratovsky
Fir a spring-based API check out https://github.com/springfox/springfox/. I’m not familiar enough with XMLBeans to tell you if it can work with it. From: 'Karishma Dalal' via Swagger Reply-To: "swagger-swaggersocket@googlegroups.com" Date: Wednesday, September 27, 2017 at 11:26 To: "s

Re: Generate Swagger documentation during Runtime in J2SE legacy application

2017-09-27 Thread 'Karishma Dalal' via Swagger
We use JAVA Spring framework to expose our REST API. On Wed, Sep 27, 2017 at 11:21 AM, Ron Ratovsky wrote: > XMLBeans is used to describe the objects being transferred, not the API. > > Which framework do you use to expose your REST API? > > > > > > > > *From: *'Karishma Dalal' via Swagger goog

Re: Swagger workflow Server Stubs code generation

2017-09-27 Thread Ron Ratovsky
Take a look at https://github.com/swagger-api/swagger-codegen#ignore-file-format. From: on behalf of Mark Anderson Reply-To: "swagger-swaggersocket@googlegroups.com" Date: Tuesday, September 26, 2017 at 20:48 To: Swagger Subject: Swagger workflow Server Stubs code generation Af

Re: Generate Swagger documentation during Runtime in J2SE legacy application

2017-09-27 Thread Ron Ratovsky
XMLBeans is used to describe the objects being transferred, not the API. Which framework do you use to expose your REST API? From: 'Karishma Dalal' via Swagger Reply-To: "swagger-swaggersocket@googlegroups.com" Date: Wednesday, September 27, 2017 at 11:20 To: "swagger-swaggersocket@go

Re: Generate Swagger documentation during Runtime in J2SE legacy application

2017-09-27 Thread 'Karishma Dalal' via Swagger
No, we do not want to describe SOAP, we want to use Swagger for REST. We already have REST in place but we want to provide something meaningful to customers - to describe the API. My point was that we use WSDL behind the scenes to generate XMLBeans. (We can overlook this, it was a workaround) Our

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 t

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: Generate Swagger documentation during Runtime in J2SE legacy application

2017-09-27 Thread Ron Ratovsky
There’s no way to use Swagger/OpenAPI to describe SOAP APIs – it can only be used for REST. From: 'Karishma Dalal' via Swagger Reply-To: "swagger-swaggersocket@googlegroups.com" Date: Wednesday, September 27, 2017 at 11:07 To: "swagger-swaggersocket@googlegroups.com" Subject: Re: Ge

Re: Generate Swagger documentation during Runtime in J2SE legacy application

2017-09-27 Thread 'Karishma Dalal' via Swagger
Hi Ron, Thanks for getting back and apologies for the late response. We use WSDL and XSD as service descriptors on JAVA Spring framework - *J2SE*. I understand WSDL is for SOAP operation but its a legacy tool and WSDL is mandatory for creating bindings. We convert WSDL into *XMLBeans*. Further, w

[Swift4] Swagger Codegen v. 2.3.0: Change in model code

2017-09-27 Thread Kim Nyhuus Hansen
Hi'! We've just upgraded from Swagger Codegen v. 2.2.3 to v. 2.3.0 in an attempt to get Xcode 9 working. However, the models that are now generated are quite different, which is causing some confusion. I'm receiving some errors from trying to initiate certain models, which seems to have change

Re: [Swift4] Swagger Codegen v. 2.3.0: Change in model code

2017-09-27 Thread Kim Nyhuus Hansen
Hi'! We've just upgraded from Swagger Codegen v. 2.2.3 to v. 2.3.0 in an attempt to get Xcode 9 working. However, the models that are now generated are quite different, which is causing some confusion. I'm receiving some errors from trying to initiate certain models, which seems to have change

[Swift4] Swagger Codegen v. 2.3.0: Change in model code

2017-09-27 Thread Kim Nyhuus Hansen
Hi'! We've just upgraded from Swagger Codegen v. 2.2.3 to v. 2.3.0 in an attempt to get Xcode 9 working. However, the models that are now generated are quite different, which is causing some confusion. I'm receiving some errors from trying to initiate certain models, which seems to have change

Externally defined XML Schema

2017-09-27 Thread benjamin_preston2004 via Swagger
Despite numerous attempts to ask this question on this forum and elsewhere and despite sitting in on the Open API 3.0 Webinar sessions yesterday and asking questions (which weren't selected) I am yet to get any clarity on the following: Many organisations have invested time in defining XML Sc

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

2017-09-27 Thread Chang Zhiyuan
Is there some advice for version location? for example : in path or base path -- 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...@googl