Can customize each field by giving its own definition.

Has sole control over the one who manages this documentation.

Can update the documentation based on further needs.

An easy way to give access and provide necessary information on the API workflow & its nature. Review collected by and hosted on G2.com.

Time-consuming & costly to prepare.

Requires an immense amount of work if any changes needs to be done with the existing workflow.

Needs to be patient with the documentation of each API definition & structure.

Every code return for the definition structure must follow strict syntax else tracing errors is difficult. Review collected by and hosted on G2.com.

Swagger UI is good so that we can easily understand what is the requirement to develop a particular endpoint and even it is good for QA people to understand all the required data for a particular endpoint so that they can test it without asking to developer Review collected by and hosted on G2.com.

minimization and expansion of the particular API block can be approved i.e. when we have a lot of endpoints is listed on swagger so it is hard to navigate between different endpoints. Review collected by and hosted on G2.com.

User friendly. Easy to integrate with code. Review collected by and hosted on G2.com.

still there is updates going on. need a standerd Review collected by and hosted on G2.com.

We are documenting the API with. The easy way to integrate and generate API SDK files is to handle all the required parameters for the API like authentication token etc. OpenAPI npm package helps a lot to generate SDK files Review collected by and hosted on G2.com.

Regarding the security we have major concerns. As it is a cloud offering, we have to add all the tokens and security credentials on the hub portal to check whether the API working it or not. This may be a threat that adding those details on the third party site. Review collected by and hosted on G2.com.

I like the way how it converts the YAML file of the API documentation into the workable API playground including payloads, authorization, etc.. And also versioning of the documents file. Review collected by and hosted on G2.com.

Modifying the YAML file to get the desired out makes pain. Because the indentation of the YAML files makes an important role. If something not in proper format, the entire document will collapse. Review collected by and hosted on G2.com.

A swagger is actually an awesome tool to automatically document your API once it is integrated, it provides a great User interface to see the structure and schema of API and executes commands directly! Review collected by and hosted on G2.com.

we are using sails.js as a backend framework and integrating swagger with sails.js is really hard and painful process, lack of tutorials on the internet and documentation to integrate with sails is not that great actually, but once it's integrated after that it works smooth! Review collected by and hosted on G2.com.

As an API consumer, you can extract the definitions of APIs and use it. For any API design, documentation is critical than the code because all developers will focus on documents; only Swaggerhub has a great facility to build documents.

Ability to create organizations is very helpful. For example, if you are working for multiple orgranizations you can easily have track of your work independently. Review collected by and hosted on G2.com.

The user interface might be confusing for the new developers. I have seen some of the API documentations contain junk characters as well. So a lot of work is required in that area. Also, API testing is not possible. Review collected by and hosted on G2.com.

It makes it easy to share or use together for collaborative projects for the team and within the group, also helpful to organizations when they want to document the API. I feel elementary while communicating about the API endpoint version between various stakeholders and teams using the swaggerHub comments section. Swagger Hub is an open-source software platform that any individual or business can use for free of cost. And can also use the support of swaggerHub for its team, although swaggerHub charges a few $ dollars for its team package features and support on a monthly and annual basis. Review collected by and hosted on G2.com.

Creating API documentation from scratch is not very friendly for beginners, also a lack in the testing of API endpoints. While updating or creating new entries of API, it's not very easy to maintain indentation, and It took more than expected time. Review collected by and hosted on G2.com.

Very easy way to share the API related documents without any mannual interventions. just do coding and document will get automatically. Review collected by and hosted on G2.com.

User Interface need to be improved. It should enable setting environment variable configuration so that when there is change in the deployment server details simply change variable details. Review collected by and hosted on G2.com.

1. Api documentation mainer swagger UI documentation automation and gives all the details of API starting from the payload to response.

2. Make the life of developer/QA easy while testing Rest APIs.

3. Secure API by token-based authentication support, so that it's not exposed to the outside world. Review collected by and hosted on G2.com.

1. Nothing as such but difficult to test OpenApi.

2. Without reading the documentation it's difficult to use, but once you grasp it works like a charm. Review collected by and hosted on G2.com.