Stoplight Reviews & Product Details - Page 20

- A robust visual editor for OpenAPI documents

- Instant preview of API spec edits

- Ability to internally review unpublished spec changes

- Team collaboration

- Git integration

- Built-in linting and mocking tools

- Automatic API docs generation Review collected by and hosted on G2.com.

- The UI is a bit confusing, feels like a tool built by developers. Although it has received some great improvements recently

- The generated docs could have easier navigation and discoveray

- Generated docs aren't responsive (but they're planning on addressing it)

- Cross-linking between articles or API endpoints is a pain

- Not enough control of what items from the OpenAPI document appear in the navigation sidebar and in what order

- Not enough customization when you embed Stoplight's docs into your own site, but they're planning on addressing it in the next version Review collected by and hosted on G2.com.

The straightforward user interface makes creating mockups for API endpoints and database models a breeze. Having migrated from other platforms that force you to develop your API specs in YAML/JSON formats, I realized I was wasting more of my time figuring out the structure for writing API mockups than writing the mockups themselves. Since using Stoplight, almost all of my time dedicated to architecture planning has been spent actually planning the architecture, rather than having to validate my schema every couple of minutes.

The amount of detail that Stoplight allows me to provide for my models and endpoints, all through a UI editor without ever needing to switch to code, is fantastic. Stoplight does also offer the option to edit the code it generates (either in JSON or YAML format), though I rarely tend to use that. Review collected by and hosted on G2.com.

There is nothing about Stoplight that I dislike, though there are some pet peeves I have from my time using the service.

I usually provide an API response example for every HTTP status that my endpoints return. The majority of responses often include the use of Stoplight models (such as returning a user model from a `GET /users/:id` endpoint), though Stoplight does not update the examples if the model returned in the example is modified. This has little impact on my smaller project, though I can imagine large-scale projects running into issues where outdated models are returned as part of the example.

Another minor issue is the lack of sorting options for schemas. Whilst I completely understand JSON objects don't actually have any order, I often see myself switching to the code editor just to move API fields around in my schemas to just add a little bit more logic to what the model represents. For instance, I tend to keep any "metadata" fields (such as a title, slug, etc.) at the top of the schema, and everything else below. When constantly iterating on these designs, things often get moved around and separated which can make the model seem more complicated than it is. Review collected by and hosted on G2.com.

Spotlight has a feature that has an AI based autofill tool that makes constructing new APIs very easy, and if it is based off of another existing model, it is even simpler. Review collected by and hosted on G2.com.

I think like most things, cost could always be improved. Stoplight is able to support bigger businesses, but they're pricing model prevents them from helping out smaller ones. Review collected by and hosted on G2.com.

* Ability to manage documentation as Code, in Git repo, CI/CD integration and also ability to preview and publish.

* Stoplight is the only SaaS based solution that allowed to to keep the workflow closer to the dev workflow

* It ability to allow tech and non-tech users collaborate is awesome.

* Publish API and general documentation relative to each other is wonderful Review collected by and hosted on G2.com.

* Images need to be publicly accessible.

* Images in private Git repo are not supported.

* Not able to have documentation tied to multiple "environments". It has only pre-publish, and publish views, If it allowed a simple way to tie multiple envronments to the corresponding documentation and promote together it would have been more awesome. Review collected by and hosted on G2.com.

This product is fantastic. It is robust monitoring help to the database. We cannot go and check manually. it is best Review collected by and hosted on G2.com.

nothing is dislike, only one think is the priceing model become a higher, so if a smaller business cannot afford this Review collected by and hosted on G2.com.

Stoplight allowed me to jump into writing the API docs immediately without any hassle.

First of all, the interface was incredibly intuitive, and it was straightforward to do simple things like creating new page manuals and writing the API itself. When I logged in for the first time, it took me all but a few clicks to get started on writing.

The default layout was also incredibly professional-looking, and for those who are like me that do not require any bells & whistles in terms of the look & feel of the documentation, you would find Stoplight more than sufficient. Review collected by and hosted on G2.com.

One of the issues with the generated docs is the lack of mobile responsiveness of the generated documentation but it is already on their roadmap.

It's not a huge issue as API docs are rarely accessed over the phone but there are potential consumers that do check out documentation using their phones and this can be a cause of deterrent.

If you ever want to stop using it, you can simply export your existing work and work on it elsewhere. Review collected by and hosted on G2.com.

Very easy to use platform that is constantly delivering new features to assist with all things APIs. Great blogs around best practices and guidance on designing and building APIs. I also like the inbuilt mocking ability and the fact that the responses can by dynamic and even generated using Faker to make them more realistic. Review collected by and hosted on G2.com.

Licensing costs- can be quite costly for smaller teams where all members need to edit the spec.

Their support response times can be a little slow sometimes especially for me given I'm based in Australia and they are on the other side of the globe which means it can sometimes be a couple of days turn around on my enquiries. Review collected by and hosted on G2.com.

Have a refreshing interface; also use versioning it GitLab. It's an excellent feature. The Dark mode is incredible; looks cleaner. Also, I can select to use JSON or YAML structure. I'm excited about how this tool can evolve in the future. Review collected by and hosted on G2.com.

You cant export to JSON your models or structures created in the custom responses. That would be a cool feature to export examples made with the UI in YAML or JSON, some button or option in the UI. Creating a new branch for every commit can create a mess in Gitlab. The navigation menu in the dashboard would present the Endpoints in a folder, not all at the same lvl. Review collected by and hosted on G2.com.

I liked how simple it is to setup API documentation with mocking and all features. It is very easy to share and has a clean, simple UI. I also love that all files are stored as YAML in your own github repo so you can easily migrate to any other tool if needed Review collected by and hosted on G2.com.

I would have loved to see more control over the link sharing settings. Maybe I want it to be private or visible to only a few people etc. Also the product onboarding can be better. For the most part I had knowledge about it so I was able to figure things out but in general people might need some help to get started. Review collected by and hosted on G2.com.

The user interface, references to schemas, mock server, GIT integration, free plan to use the service Review collected by and hosted on G2.com.

The lack of bulk operations, performance issues while opening docs, response time to tickets relatively slow Review collected by and hosted on G2.com.