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
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:
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,
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
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,
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
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
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"
- 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
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
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
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"
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.
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
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
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
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"
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
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"
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"
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
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
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
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,
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:
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
, 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
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
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"
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
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:
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
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
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
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"
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,
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:
@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
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,
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
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
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"
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"
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"
`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
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"
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
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@
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"
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
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:
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:
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:
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
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:
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
OpenAPI doesn’t allow you to define interdependencies between parameters.
From: on behalf of Lavin Motwani
Reply-To: "swagger-swaggersocket@googlegroups.com"
Date: Monday,
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
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
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,
Not really sure which tools you’re referring to.
From: on behalf of
"jaychandransubraman...@gmail.com"
Reply-To: "swagger-swaggersocket@googlegroups.com"
Date: Friday,
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
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"
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
, 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.
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"
Replace your schema with:
schema:
type: object
properties:
user_agents:
type: array
items:
type: object
properties:
user_agent_id:
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"
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"
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,
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"
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
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
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:
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:
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
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
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:
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"
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
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"
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
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:
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"
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:
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:
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
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"
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:
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
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,
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
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
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
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:
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"
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"
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:
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:
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
101 - 200 of 515 matches
Mail list logo