Anordnen mehrerer REST API Swagger-Spezifikationen

Question

Wir verwenden die Swagger-basierte REST-API-Spezifikation für verschiedene Projekte. Jedes Projekt verfügt daher über eine eigene Swagger-Benutzeroberfläche mit einer Beschreibung der Endpunkte. Alle diese UIs werden auf verschiedenen Servern unter verschiedenen Domänennamen bereitgestellt, was aus der Perspektive der Organisation überhaupt nicht cool ist.

Gibt es eine nette Möglichkeit, mehrere Swagger-Spezifikationen an einem einzigen Ort zu speichern? Es könnte sich um einen Dienst für eine REST-API-Beschreibungsverwaltung handeln, der die Swagger-Spezifikation verwendet.

Answer 1

fand ich einige schöne Möglichkeiten für ein Management-API-Spezifikationen REST:

• Apiary (apiary.io)
• Restlet (restlet.com)
• SwaggerHub (swaggerhub. com)

Alle drei Dienste unterstützen die OpenAPI Specification, die auf der Swagger 2.0 Spezifikation basiert.

Imkerei verfügt über ein gutes Zusammenarbeitsmanagement und unterstützt eine REST-API-Validierung. Allerdings ist es ziemlich teuer. Ein geeigneter Plan kostet 99 $ pro Monat: impair.io/pricing

Restlet hat auch eine Möglichkeit für eine Zusammenarbeit und es unterstützt eine funktionale Prüfung. zu Apiary Vergleich, hat Restlet eine bessere Auswahl der Preisoptionen: restlet.com/pricing

SwaggerHub ist die optimale Wahl in meinem Fall. Es wurde speziell für die Verwaltung mehrerer Swagger-Spezifikationen entwickelt. Der Service unterstützt alle für Swagger entwickelten Code-Generatoren. Im Gegensatz zu Apiary und Restlet bietet es jedoch keine REST-API-Test-/Validierungswerkzeuge. Der größte Vorteil von SwaggerHub ist die Preisgestaltung. Ein Verhältnis von Spezifikationsnummern pro $ ist das beste mit einer maximalen Anzahl von 25 Mitarbeitern pro API: swaggerhub.com/prices