Stoplight Bewertungen & Produktdetails

- Ein robuster visueller Editor für OpenAPI-Dokumente

- Sofortige Vorschau von API-Spezifikationsänderungen

- Möglichkeit zur internen Überprüfung unveröffentlichter Spezifikationsänderungen

- Teamzusammenarbeit

- Git-Integration

- Eingebaute Linting- und Mocking-Tools

- Automatische Generierung von API-Dokumentationen Bewertung gesammelt von und auf G2.com gehostet.

- Die Benutzeroberfläche ist etwas verwirrend, fühlt sich an wie ein von Entwicklern gebautes Werkzeug. Obwohl es kürzlich einige großartige Verbesserungen erhalten hat.

- Die generierten Dokumente könnten eine einfachere Navigation und Entdeckung haben.

- Generierte Dokumente sind nicht responsiv (aber sie planen, dies anzugehen).

- Die Verlinkung zwischen Artikeln oder API-Endpunkten ist mühsam.

- Nicht genug Kontrolle darüber, welche Elemente aus dem OpenAPI-Dokument in der Navigationsleiste erscheinen und in welcher Reihenfolge.

- Nicht genug Anpassungsmöglichkeiten, wenn man die Dokumente von Stoplight in die eigene Website einbettet, aber sie planen, dies in der nächsten Version anzugehen. Bewertung gesammelt von und auf G2.com gehostet.

Die benutzerfreundliche Oberfläche macht das Erstellen von Mockups für API-Endpunkte und Datenbankmodelle zum Kinderspiel. Nachdem ich von anderen Plattformen migriert bin, die einen zwingen, die API-Spezifikationen in YAML/JSON-Formaten zu entwickeln, habe ich erkannt, dass ich mehr Zeit damit verschwendet habe, die Struktur für das Schreiben von API-Mockups herauszufinden, als die Mockups selbst zu schreiben. Seit ich Stoplight benutze, wird fast meine gesamte für die Architekturplanung vorgesehene Zeit tatsächlich für die Planung der Architektur verwendet, anstatt alle paar Minuten mein Schema validieren zu müssen.

Die Menge an Details, die Stoplight mir ermöglicht, für meine Modelle und Endpunkte bereitzustellen, alles über einen UI-Editor, ohne jemals in den Code wechseln zu müssen, ist fantastisch. Stoplight bietet auch die Möglichkeit, den von ihm generierten Code zu bearbeiten (entweder im JSON- oder YAML-Format), obwohl ich das selten nutze. Bewertung gesammelt von und auf G2.com gehostet.

Es gibt nichts an Stoplight, das mir nicht gefällt, obwohl es einige kleine Ärgernisse gibt, die ich aus meiner Zeit mit dem Dienst habe.

Normalerweise gebe ich ein API-Antwortbeispiel für jeden HTTP-Status an, den meine Endpunkte zurückgeben. Die Mehrheit der Antworten beinhaltet oft die Verwendung von Stoplight-Modellen (wie das Zurückgeben eines Benutzermodells von einem `GET /users/:id`-Endpunkt), obwohl Stoplight die Beispiele nicht aktualisiert, wenn das im Beispiel zurückgegebene Modell geändert wird. Dies hat wenig Einfluss auf mein kleineres Projekt, obwohl ich mir vorstellen kann, dass große Projekte auf Probleme stoßen, bei denen veraltete Modelle als Teil des Beispiels zurückgegeben werden.

Ein weiteres kleines Problem ist der Mangel an Sortieroptionen für Schemata. Während ich vollkommen verstehe, dass JSON-Objekte eigentlich keine Reihenfolge haben, sehe ich mich oft gezwungen, zum Code-Editor zu wechseln, nur um API-Felder in meinen Schemata zu verschieben, um ein wenig mehr Logik in das zu bringen, was das Modell darstellt. Zum Beispiel neige ich dazu, alle "Metadaten"-Felder (wie einen Titel, Slug, etc.) oben im Schema zu halten und alles andere darunter. Wenn man ständig an diesen Designs arbeitet, werden Dinge oft verschoben und getrennt, was das Modell komplizierter erscheinen lassen kann, als es ist. Bewertung gesammelt von und auf G2.com gehostet.

Spotlight hat eine Funktion, die ein KI-basiertes Autofill-Tool enthält, das das Erstellen neuer APIs sehr einfach macht, und wenn es auf einem anderen bestehenden Modell basiert, ist es noch einfacher. Bewertung gesammelt von und auf G2.com gehostet.

Ich denke, wie bei den meisten Dingen könnte der Preis immer verbessert werden. Stoplight ist in der Lage, größere Unternehmen zu unterstützen, aber ihr Preismodell hindert sie daran, kleineren zu helfen. Bewertung gesammelt von und auf G2.com gehostet.

* Fähigkeit, Dokumentation als Code zu verwalten, im Git-Repository, CI/CD-Integration und auch die Fähigkeit zur Vorschau und Veröffentlichung.

* Stoplight ist die einzige SaaS-basierte Lösung, die es ermöglichte, den Workflow näher am Entwickler-Workflow zu halten.

* Die Fähigkeit, es technischen und nicht-technischen Benutzern zu ermöglichen, zusammenzuarbeiten, ist großartig.

* Die Veröffentlichung von API- und allgemeiner Dokumentation in Bezug zueinander ist wunderbar. Bewertung gesammelt von und auf G2.com gehostet.

* Bilder müssen öffentlich zugänglich sein.

* Bilder in privaten Git-Repositories werden nicht unterstützt.

* Nicht in der Lage, Dokumentation mit mehreren "Umgebungen" zu verknüpfen. Es gibt nur Vorveröffentlichungs- und Veröffentlichungsansichten. Wenn es eine einfache Möglichkeit gäbe, mehrere Umgebungen mit der entsprechenden Dokumentation zu verknüpfen und gemeinsam zu fördern, wäre es noch großartiger gewesen. Bewertung gesammelt von und auf G2.com gehostet.

Dieses Produkt ist fantastisch. Es ist eine robuste Überwachungshilfe für die Datenbank. Es ist das Beste. Bewertung gesammelt von und auf G2.com gehostet.

nichts ist nicht zu mögen, nur eines ist das Preismodell, das höher wird, sodass ein kleineres Unternehmen sich dies nicht leisten kann Bewertung gesammelt von und auf G2.com gehostet.

Stoplight ermöglichte es mir, sofort mit dem Schreiben der API-Dokumentation zu beginnen, ohne jegliche Umstände.

Zunächst einmal war die Benutzeroberfläche unglaublich intuitiv, und es war einfach, einfache Dinge wie das Erstellen neuer Seitenhandbücher und das Schreiben der API selbst zu erledigen. Als ich mich zum ersten Mal anmeldete, brauchte ich nur ein paar Klicks, um mit dem Schreiben zu beginnen.

Das Standardlayout sah auch unglaublich professionell aus, und für diejenigen, die wie ich keine Schnickschnack in Bezug auf das Aussehen und Gefühl der Dokumentation benötigen, würde Stoplight mehr als ausreichend sein. Bewertung gesammelt von und auf G2.com gehostet.

Eines der Probleme mit den generierten Dokumenten ist der Mangel an mobiler Reaktionsfähigkeit der generierten Dokumentation, aber es steht bereits auf ihrer Roadmap.

Es ist kein großes Problem, da API-Dokumentationen selten über das Telefon aufgerufen werden, aber es gibt potenzielle Nutzer, die Dokumentationen mit ihren Telefonen überprüfen, und dies kann abschreckend wirken. Bewertung gesammelt von und auf G2.com gehostet.

Sehr einfach zu bedienende Plattform, die ständig neue Funktionen liefert, um bei allen Dingen rund um APIs zu unterstützen. Tolle Blogs über Best Practices und Anleitungen zum Entwerfen und Erstellen von APIs. Ich mag auch die eingebaute Mocking-Funktion und die Tatsache, dass die Antworten dynamisch sein können und sogar mit Faker generiert werden können, um sie realistischer zu machen. Bewertung gesammelt von und auf G2.com gehostet.

Lizenzkosten - können für kleinere Teams, in denen alle Mitglieder die Spezifikation bearbeiten müssen, ziemlich teuer sein.

Ihre Antwortzeiten beim Support können manchmal etwas langsam sein, insbesondere für mich, da ich in Australien ansässig bin und sie auf der anderen Seite der Welt sind, was bedeutet, dass es manchmal ein paar Tage dauern kann, bis ich eine Antwort auf meine Anfragen erhalte. Bewertung gesammelt von und auf G2.com gehostet.

Haben Sie eine erfrischende Benutzeroberfläche; verwenden Sie auch Versionierung in GitLab. Es ist eine ausgezeichnete Funktion. Der Dunkelmodus ist unglaublich; sieht sauberer aus. Außerdem kann ich wählen, ob ich die JSON- oder YAML-Struktur verwenden möchte. Ich bin gespannt, wie sich dieses Tool in Zukunft entwickeln kann. Bewertung gesammelt von und auf G2.com gehostet.

Sie können Ihre Modelle oder Strukturen, die in den benutzerdefinierten Antworten erstellt wurden, nicht in JSON exportieren. Das wäre eine coole Funktion, um Beispiele, die mit der Benutzeroberfläche erstellt wurden, in YAML oder JSON zu exportieren, mit einer Schaltfläche oder Option in der Benutzeroberfläche. Das Erstellen eines neuen Branches für jeden Commit kann in Gitlab ein Chaos verursachen. Das Navigationsmenü im Dashboard würde die Endpunkte in einem Ordner präsentieren, nicht alle auf derselben Ebene. Bewertung gesammelt von und auf G2.com gehostet.

Ich mochte, wie einfach es ist, API-Dokumentation mit Mocking und allen Funktionen einzurichten. Es ist sehr einfach zu teilen und hat eine saubere, einfache Benutzeroberfläche. Ich liebe auch, dass alle Dateien als YAML in Ihrem eigenen GitHub-Repo gespeichert werden, sodass Sie bei Bedarf problemlos zu einem anderen Tool migrieren können. Bewertung gesammelt von und auf G2.com gehostet.

Ich hätte gerne mehr Kontrolle über die Einstellungen zum Teilen von Links gesehen. Vielleicht möchte ich, dass es privat ist oder nur für einige wenige Personen sichtbar usw. Auch das Produkt-Onboarding könnte besser sein. Zum größten Teil hatte ich Kenntnisse darüber, sodass ich in der Lage war, die Dinge herauszufinden, aber im Allgemeinen könnten Menschen etwas Hilfe benötigen, um loszulegen. Bewertung gesammelt von und auf G2.com gehostet.

Die Benutzeroberfläche, Verweise auf Schemata, Mock-Server, GIT-Integration, kostenloser Plan zur Nutzung des Dienstes Bewertung gesammelt von und auf G2.com gehostet.

Das Fehlen von Massenoperationen, Leistungsprobleme beim Öffnen von Dokumenten, relativ langsame Reaktionszeit auf Tickets Bewertung gesammelt von und auf G2.com gehostet.