Stoplight Bewertungen & Produktdetails

Die Organisation von Endpunkten und Modellen sowie die Online-Dokumentation. Bewertung gesammelt von und auf G2.com gehostet.

Manchmal werde ich verwirrt, wenn ich versuche, ein Modell zu finden, das ich versehentlich in freigegebenen Objekten gespeichert habe. Es könnte eine Bestätigungsnachricht vor dieser Art von Aktion geben (etwas wie: Möchten Sie dieses Modell wirklich freigeben?). Bewertung gesammelt von und auf G2.com gehostet.

Die kollaborativen OAS-API-Design-Funktionen von Stoplight waren äußerst wertvoll, um unser Team dazu zu bringen, API-Mängel bei mehreren unserer Dienste anzugehen. Teams können gebildet und bestimmten APIs zugewiesen werden, die für die Organisation entwickelt werden. Das Tool selbst hat es unseren Teams ermöglicht, fehlende oder mangelhafte APIs für mehrere Dienste anzugehen und dies auf eine OAS-konforme Weise zu tun. In den meisten Fällen waren die Dienste bereits vorhanden, hatten jedoch keine (oder nur begrenzte) API. Stoplight förderte eine schnelle, mit wenig Arbeitsstunden verbundene Einarbeitung von Entwicklern und das anschließende API-Design, um die Mängel zu beheben. Im Falle eines neu hinzugefügten Dienstes ermöglichte Stoplight dem Team, einen API-First-Ansatz zu verfolgen, was bisher selten der Fall war und wahrscheinlich nicht geschehen wäre – oder nicht mit ausreichender Klarheit und Formalismus – ohne Stoplight. Unsere Gruppe ist klein, wobei Entwickler im Allgemeinen für die meisten Phasen der Softwareentwicklung ihrer zugewiesenen Projekte verantwortlich sind und es nur wenige formale Prozesse gibt. Die Integration von Stoplight in die vorhandenen Entwicklungsprozesse wurde sehr positiv aufgenommen und war nicht mit hohen Einarbeitungs- oder Opportunitätskosten verbunden, was eine entscheidende Anforderung war. Der Einsatz von Stoplight legte größeren Wert auf das API-Design vor der Implementierung, was eine bessere Planung ermöglichte, in einigen Fällen eine Überprüfung und Beiträge anderer Teammitglieder erlaubte und eine etwas schnellere und umfassendere Implementierung ermöglichte, als dies sonst der Fall gewesen wäre. Bewertung gesammelt von und auf G2.com gehostet.

Wie einige andere wurden auch wir in eine Beta-Version von Stoplight Next aufgenommen, was anfangs einige Probleme verursachte. Da dies jedoch mit der Notwendigkeit der Teammitglieder zusammenfiel, Wissenslücken in Bezug auf OAS zu schließen, war die Auswirkung dieser Probleme gering. Derzeit haben wir mehr Probleme mit der Veröffentlichung der Dokumentation (und der OAS-Spezifikation, die über die API verfügbar ist) und der ansprechenden Präsentation der Dokumentation. Dies könnte auch unsere Unkenntnis der Möglichkeiten widerspiegeln oder Einschränkungen in der Dokumentationsproduktion von Stoplight widerspiegeln; wir sind uns noch nicht sicher. Darüber hinaus haben wir Bedarf an nicht-OAS-API-Dokumentation, obwohl dies möglicherweise nicht in den Anwendungsbereich von Stoplight fällt. Bewertung gesammelt von und auf G2.com gehostet.

Nach der Bewertung mehrerer Produkte zur Dokumentation mehrerer REST-APIs - Postman, Swagger, API Blueprint und der Hauptunterscheidungsmerkmal für mich waren:

- die Fähigkeit, OAS-Stil-Dokumentation und Markdown-Seiten zu mischen, was ein All-in-One-Tool bietet, um die gesamte API-Dokumentation zu schreiben.

- ein schöner Editor für die OAS-Dokumentation, der sowohl eine Benutzeroberfläche als auch eine Möglichkeit bietet, JSON-Daten direkt zu bearbeiten.

Das Team war während der Testphase und auch nachdem ich zahlender Kunde wurde, sehr reaktionsschnell auf Fragen. Sie waren auch offen für meine Funktionsanfragen.

Die neue Version (Next) hat sich seit ihrer Einführung vor ein paar Monaten gut entwickelt. Bewertung gesammelt von und auf G2.com gehostet.

Ich begann, StopLight zu verwenden, als Next in der Beta-Phase war. Ich stieß auf ein paar kleinere Probleme, aber das Team war reaktionsschnell bei deren Behebung, und ich habe seit Wochen keine Probleme mehr gehabt. Bewertung gesammelt von und auf G2.com gehostet.

Die Fähigkeit, mit einer Anzahl von Personen zur gleichen Spezifikation beizutragen. Was unter der Haube in OAS übersetzt wird. Die Einfachheit der Definition von Modellen und Tests im Tool. Automatisch Dokumentation in HTML veröffentlichen... Bewertung gesammelt von und auf G2.com gehostet.

Der gleiche Benutzer in mehreren Organisationen wird in jeder Organisation abgerechnet. In unserem Unternehmen verwenden wir Stoplight für alle unsere Kunden, aber wenn der Kunde beitragen möchte, müssen wir ein Projekt in einer separaten Organisation erstellen (auf diese Weise kann der Kunde die anderen Projekte anderer Kunden nicht sehen). Der Nachteil ist, dass jeder Benutzer auf unserer Seite für jede Organisation abgerechnet wird. Bewertung gesammelt von und auf G2.com gehostet.

Ich liebe, wie zugänglich Stoplight für alle in unserer Organisation ist. Es ist zu einem unverzichtbaren Werkzeug für die Planung und Organisation unserer API geworden - ein Werkzeug, das sogar nicht-technische Personen verstehen und begreifen.

Ich liebe auch die gehostete Dokumentation - sie ist schnell und stabil. Bewertung gesammelt von und auf G2.com gehostet.

Ich komme zu Stoplight und bin wirklich an die OpenAPI (Swagger) Spezifikation gewöhnt. Manchmal ist es wirklich schwierig herauszufinden, wie man etwas mit Stoplight macht, das ich bereits in der OpenAPI-Spezifikation kenne. Bewertung gesammelt von und auf G2.com gehostet.

As a Technical writer I need a friendly tool, with an easy-to-use interface so I can better collaborate with the development teams in the development and review of the documentation of our APIs. Its integration with Git allows teams to collaborative in a coordinated way. Bewertung gesammelt von und auf G2.com gehostet.

Stoplight seems to be an immature tool yet, so now and them I stumble upon errors, or I miss things that I think should be there already. For example, I’ve noticed than when had unsaved changes, Stoplight wouldn’t make me aware of that, and then I’d lose my work (This is fixed now). Bewertung gesammelt von und auf G2.com gehostet.

Das Entwerfen einer API ist äußerst intuitiv und einfach. Mock-Tests sind leicht zu konfigurieren. Wir ermöglichen die gleichzeitige Frontend- und Backend-Entwicklung gemäß einem in Stoplight definierten Vertrag. Bewertung gesammelt von und auf G2.com gehostet.

Verwaltung von gemeinsamen Modellen und Antworten über Projekte hinweg. In einer Microservices-Welt definieren wir viele Ampelprojekte, jedoch gibt es gemeinsame Elemente, die wir zwischen diesen Projekten teilen möchten. Dies nahtloser zu gestalten, würde eine enorme Zeitersparnis bedeuten. Bewertung gesammelt von und auf G2.com gehostet.

Die Einfachheit beim Teilen von API-Spezifikationen mit Kollegen und die Möglichkeit für alle Benutzer, diese Spezifikationen zu ändern. Die generierte Dokumentation ist ein weiteres positives Merkmal. Schließlich die Tatsache, dass wir den Code-Spezifikationen immer noch direkt bearbeiten können, in einigen Fällen, in denen wir einfach von einem anderen Ort kopieren können. Bewertung gesammelt von und auf G2.com gehostet.

Schwer zu verwendende Versionierung. Ein Killer-Feature wäre die Änderungshistorie, selbst wenn nur lokal. Bewertung gesammelt von und auf G2.com gehostet.

Organisation der Benutzeroberfläche, Mocking, sofortige Nutzung, usw. Bewertung gesammelt von und auf G2.com gehostet.

Versionierung/Commits sind seltsam/merkwürdig. Es gibt keine Dokumentation dazu. Es gibt keinen klaren Weg, aktuelle vs. WIP-Zweige des API-Designs zu haben. Habe einen Blick auf Stoplight Next geworfen und war begeistert von den Dingen, die dort erschienen, aber keine Dokumentation, die ich leicht finden konnte, also hatten wir Angst, den Sprung zu wagen. Bewertung gesammelt von und auf G2.com gehostet.

Stoplight hat eine großartige Benutzeroberfläche für API-Design, Dokumentation und generiert dann automatisch eine Swagger-Spezifikation. Der Service ist großartig und das Team reagiert auf Feedback. Bewertung gesammelt von und auf G2.com gehostet.

Wir verwenden eine ältere Version von Stoplight und sind noch nicht dazu gekommen, auf die neue Version umzusteigen. Bewertung gesammelt von und auf G2.com gehostet.