The point is, after fixing or exchanging some points on an API, there is no place to store them. The best should be a PDF, Microsoft file or a simple text file. Can SwaggerHub offer this option?
... View more
See more ideas labeled with:
We can compare two versions of an API, but there is no possibility to produce a report containing the discrepancies between two versions.
Compare popup options
Suggestion : offer a new option that allow producing a report containing the discrepancies.
... View more
See more ideas labeled with:
We have a marvelous tools to help us comparing the modifications between two api versions.
But, currently, the comparaison popup can not be resized. At the end, the usage of this functionality is very restricted.
Unable to resized this popup
My suggestion is to allow the possibility to resize the comparaison popup.
... View more
See more ideas labeled with:
0
Kudos
It s possible to extend the fixed fields in a schema. The specification indicate that we just need to prefix the extra fields with "x-". It s a good point if we want to specified spécific informations - per example the data source of a field.
But, in the produced documentations, at the end, we never see this extra fields.
My suggestion is, optionnaly, we can add/display this extra fields in the final documentation.
Currently, this is what we have :
Example - No extra field displayed
We can expect that we can see the extra field x-dataSource in the documentation.
... View more
See more ideas labeled with:
Hi ,
Please add Add in SwaggerHub to generate springboot code from api and also provide documentation in your help.
Just gone through the spring codegen tool on SwaggerHub and the code genrated project structure is not as per the standard abbreviations and nomencleture we following for RestFul APi project.
With Warm Regards
Om Prakash
... View more
0
Kudos
It would be good to have a feature which can sync java code and API definition both in the Gitlab repository.
Currently, we can choose one out of YAML/JSON resolved or server stub options .
... View more
Hi
A single page title across all pages of "Build, Collaborate & Integrate APIs | SwaggerHub" gets really tired when working in multiple browser windows.
Please could you change the page title to the name and version of the thing in the page? E.g. Acme Domain 2.0.3. Here's a story for you:
When working in multiple windows in SwaggerHub, I want the browser page title to describe what's in each tab, so I can navigate to the correct one without having to guess.
Rod
... View more
Status:
Implemented
Submitted on
12-11-2018
05:15 AM
Submitted by
daveckidd
on
12-11-2018
05:15 AM
When integrating with BitBucket we get a commit message which says "Generated code by SwaggerHub". So you can't look at your git log and see what was done.
Can we have some way of adding a useful commit message?
... View more
0
Kudos
Status:
Implemented
Submitted on
09-11-2018
04:13 AM
Submitted by
robseabright
on
09-11-2018
04:13 AM
As an owner I would like to be able to view/edit my organization's user accounts. At minimum I would like to be able to see which email address is associated with each user id.
... View more
I understand the model definition is part of Open Api specification, but this definition just helps in reference and not usable at all both for consumers and provider. Just like we can generate the code stub from the specification it will be great if we can generate schema definition in json schema with the versions.
... View more
See more ideas labeled with:
Status:
Implemented
Submitted on
05-23-2018
01:54 AM
Submitted by
sommeralex
on
05-23-2018
01:54 AM
Hi! Would be great to show the pet shop example with multiple list example for parameter selection. schema: type: array items: $ref: '#/components/schemas/MyEnumList' components: MyEnumList: type: string enum: [AllowedParameterValue1, AllowedParameterValue2, AllowedParameterValue3] reason: i googled for it but could only find: https://github.com/OAI/OpenAPI-Specification/blob/master/versions/3.0.0.md#style-values which was not really helpful as example. but thanks to really great support https://swaggerhub.drift.com/Natalie_Borovykh 😉
... View more
Could we add some validation that verifies attributes marked as mandatory are actual attributes present in the data definition. If you make an error when typing these the editor doesn't catch it as an error, the only way to see this is to review the model and verify the mandatory fields are correct. Quite a simple change but something that has caught me out several times when I've misspelled an attribute or used the wrong case!
... View more
SwaggerHub gives the opportunity for the users to integrate with several API Management platforms. WSO2 API Cloud is a public hosted version of award-winning open source WSO2 API Manager. It enables enterprises to quickly share their business capabilities with their customers and partners across the globe. It would be great if we could add it as an integration to SwaggerHub. Thanks.
... View more
0
Kudos
We need LDAP Integration for SwaggerHub. Currently, users have to manage an additional user credentials. With most of the products being LDAP-Integration enabled, we would like to expect the same for SwaggerHub. What plans do you have for this to be available?
... View more
Status:
Accepted for Discussion
Submitted on
08-24-2017
07:00 AM
Submitted by
jvogt
on
08-24-2017
07:00 AM
My team has started versioning some of our APIs. I noticed that the sort on the versions drop down was not sorted and makes it more difficult to find what you are looking for. It seems to me that by default version ascending would make sense. This is not a big deal with just a few versions, but I can see it become a pain in the future. I would expect to see 1.0.0 1.1.0 2.0.0
... View more
Status:
Accepted for Discussion
Submitted on
08-01-2017
11:22 AM
Submitted by
garethdavies
on
08-01-2017
11:22 AM
Currently, whenever a comment is made on an API with which I'm associated, I receive an email notification with a subject that is something like "gareth.davies has just added a comment to your API" (similar for replies). Since, as an Org Owner, I'm associated with dozens of APIs it is unclear from the email Subject alone which API has been commented on. Is there any way of including the API name in the Subject line?
... View more
When working on an API in SwaggerHub with multiple integrations, every time I update the API, each integration kicks in (pushing multiple commits to GitHub, updating AWS, etc). In order to iteratively work on my API in small steps, I need to disable each integration one-by-one, and then re-enable them one-by-one when I get my API where I want it to be. It would be useful to have a fast (one-click) way to disable and then re-enable all integrations so that I can work on my API without thrashing my integration targets.
... View more
An API can support several response codes and projections even in an Idempotent operation. For clients which expect to use the API and mock out the cases, they need to be able to control what case (response) their attempting to exercise. Having the mocking VertServer cycle through the possible response examples doesn't allow the api developer / integrator or tester to have reproducible results (manually or programmatic ally). It would be nice if, when making a request, the client could provide a header describing which response case it would like to exercise. It would also be nice if the virt server baseUrl was not stored as part of the contract and could be turned on or enabled on a request basis so administrators wouldn't have to change the contract just for a client / team to test the mock contract.
... View more
I'd like to add another contributor permission and differentiate those users which can edit the contract vs. those who can edit the descriptions. This is important as we'd like to add Tech writers as a contributor, however we want to be careful that they can't accidentally change the contract.
... View more
The generation of c# puts descriptions in the <Remarks> tag for the operation on the controller. This is ok but it tends to pollute the code and doesn't preserve the white space of the markdown. We'd like to have swaggerhub generate resource files that we can link into our c# micro-service and use the swashbucke IDocumentFilter to read those files from code resources and provide them in swagger output. This would also allow us to handle localization concerns in the future much more effectively. Why: because once we generate the code, we push our micro-service through our continuous delivery process and only publish to our gateway from the micro-service host swagger. So the format of those descriptions need to be maintained and presented by the code itself.
... View more
