Stoplight Pros and Cons

The spectral rules are really great and help me keep my OpenAPI files clean, and the Proposals section is really helpful for version compatibility. Review collected by and hosted on G2.com.

I find the role-based access to be confusing and a little difficult to manage. Inviting a guest to my API project is too many steps. Review collected by and hosted on G2.com.

The user interface for the desktop version is excellent, and the support for GIT makes collaboration easy Review collected by and hosted on G2.com.

I found the web UI to have some bugs, which were very frustrating. These were not present in the desktop version. Review collected by and hosted on G2.com.

Mock testing enables contract based development Review collected by and hosted on G2.com.

Odd navigation to splash page and basic text editor Review collected by and hosted on G2.com.

I appreciate how simple the ui is to operate and how simple the design & feel and documentation can be modified. It really is great that it is able build server files in different languages such as Java, Python, and JavaScript. It integrates using our user introspection and secure file models while offering a broad range of dependability and polymorphism features. Moreover, it contains the key expressions that assist in runtime evaluation and assist us choose the URL to use for our callback request. Here wecan review and publish api designs. Review collected by and hosted on G2.com.

To compete with other API verification software products, they must provide more capabilities. If there are any adjustments that need to be made to the current workflow, it will take a tremendous amount of labour. Even though it can produce documents, a new function that turns those documents into wiki pages might make the product even more valuable. A strict syntax must be followed by each code return for the definition structure; else, faults are hard to track down. Review collected by and hosted on G2.com.

Design, code and test with minimum knowledge of OpenAPI specs. Define generic models, find them and use them where it fits best. Integration with various code control tools. Review collected by and hosted on G2.com.

Addition of x-stoplight tags. Inability to refactor when the Model is changed, and it's being referred across other specs. Finding and changing the yaml code experience is not good. Review collected by and hosted on G2.com.

Ability to use GUI to document endpoints. Easy to use, easy to spot a problem. Review collected by and hosted on G2.com.

I don't have something to complain about. Review collected by and hosted on G2.com.

Very easy to document APIs without widespread knowledge of OpenAPI standard.

What sealed the deal for me was:

1. the ability to get a mockup of an API request/reponse body schema starting from JSON content;

2. the dynamically-generated API response examples.

API Docs are fairly neat and clear. Review collected by and hosted on G2.com.

A few basic features of OpenAPI specification, like server variables, still need to be supported.

I understand it's somehow a "young" product (2019), but sometimes I feel something may still need some refinement/polishing. Review collected by and hosted on G2.com.

Stoplight is a very powerful tool that allows me to create documentation for an API. I can then share this documentation with my clients so they can develop their tools. Review collected by and hosted on G2.com.

The large number of options makes the interface a bit complicated and requires some time to learn. Review collected by and hosted on G2.com.

Its easy to use and explain to others. Its also easy to collaborate and integrate it with our VCS Review collected by and hosted on G2.com.

It would be great if you could more easily create also a documentation that does not follow OpenAPI standard e.g. a JSON RPC documentation.

Its is kind of hard to provide the correct endpoints or to provide examples Review collected by and hosted on G2.com.

- Very simple to use binary-like feature flags

- I find very helpful the variable, once created, is available on all environments

- Really easy API

- We also integrated to Slack, so it's cool having messages when the status of a flag changes, so that we are aware if some colleague changes something that might impact us

I'm excited to someday use the most complex features, like nested feature flags, non-binary, distribution of values based on some targetting rules, etc. Review collected by and hosted on G2.com.

- I found a little confusing and redundant the need to manage, for simple binary-like flags, the targetting (on/off), the default rule(on/off), and if targetting is off what to serve(on/off). Review collected by and hosted on G2.com.