it-swarm.com.de

Warum gibt es keine Themen für Swagger-Ui?

Ich mag Swagger für das Dokumentieren von Restful-APIs, besonders "Try it out!" button, aber swagger-ui interface sieht nicht sehr cool aus.

Und ich kann nicht glauben, dass es keine Vorlagen für solch ein erstaunliches Open Source-Tool gibt (oder ich kann keine finden)?

Ich möchte es nicht kostenlos. Wie http://getbootstrap.com/ gibt es viele Websites, auf denen Designs gekauft werden können (wie https://wrapbootstrap.com/ ), weshalb ich keine finden kann Website für Prahlerei-Themen?

54

Eine späte Antwort, wenn auch eine gute. Das ist ziemlich großartig! Eine glatte Implementierung, und er hat viele Dinge angepasst, die leicht noch einmal an Ihre Bedürfnisse angepasst werden können: https://github.com/jensoleg/swagger-ui

Die Credits gehen an diese Google-Gruppe: https://groups.google.com/forum/#!topic/swagger-swaggersocket/oeMyayrvKRI . Seltsam, dass dies hier noch nicht veröffentlicht wurde.

Eine Action-Demo finden Sie unter folgendem Link: http://senodio.com/site/swagger/#!/pet/addPet

-

BEARBEITEN: Vor kurzem wurde festgestellt, dass die DEMO nicht verfügbar ist. Daher habe ich das Repo ( https://github.com/MartinSahlen/swagger-ui ) gegabelt und einen einfachen Knoten/Express-Server erstellt, der auf Heroku ausgeführt wird. Bitte beachten Sie, dass dies ein kostenloses Heroku-Dyno ist. Daher kann es eine Weile dauern, bis das Gerät geladen ist (~ 20 Sek.), Wenn es einige Zeit lang zu wenig Aktivität auf ihm hat.

Bitte: http://sleepy-harbor-80783.herokuapp.com/#!/pet/addPet

EDIT 2: Ich bin gerade auf einen anderen gestoßen, der vielversprechend aussieht: https://github.com/legendecas/material-swagger-ui . Es scheint auch, dass der Prahler ui ich bin Das Hosting ist jetzt unter http://swaggerui.herokuapp.com/ wiederbelebt. Meinen auch behalten, falls es wieder heruntergenommen wird.

69
martin.code

Dies ist eine Sammlung von Stylesheet-Designs, die auf die Swagger-Benutzeroberfläche angewendet werden können. Link unten zu meinem Repo zur Verwendung. 

Hoffe das hilft.

https://github.com/ostranme/swagger-ui-themes

13
ostranme

Die Swagger-UI ist zwar kein neues Werkzeug, aber sehr spezifisch für ihre Aufgabe. Mir ist keine Website bekannt, in der Themen (kostenlos oder kostenpflichtig) bereitgestellt werden. Viele Benutzer haben die Benutzeroberfläche an ihr lokales Thema angepasst. Einige haben geringfügige Änderungen vorgenommen, andere eine komplette Überholung.

Ich würde empfehlen, sich die verfügbaren Implementierungen anzusehen und herauszufinden, ob etwas zu Ihren Bedürfnissen passt. Dann bitten Sie vielleicht um Erlaubnis, das Thema/die Vorlage für Ihre eigenen Zwecke wiederzuverwenden.

5
Ron

Eine weitere Option ist ReDoc .

Sie müssen nur Ihre swagger.json -Datei mit einer index.html mitbringen. Einfache Einstellung.

<head>
    <title>ReDoc</title>
    <meta charset="utf-8"/>
    <meta name="viewport" content="width=device-width, initial-scale=1">
    <link href="https://fonts.googleapis.com/css?family=Montserrat:300,400,700|Roboto:300,400,700" rel="stylesheet">
    <style>
      body {
        margin: 0;
        padding: 0;
      }
    </style>
  </head>
  <body>
    <redoc spec-url='your.swagger.json'></redoc>
    <script src="https://cdn.jsdelivr.net/npm/[email protected]/bundles/redoc.standalone.js"> </script>
  </body>
3
user1917528

Ich habe vor kurzem das oben gemeinsam benutzte Swagger-ui-Thema mit Bootstrap v4 für alle, die Interesse haben, überarbeitet. Sehen Sie es hier https://github.com/afgarcia86/bootstrap-swagger-ui

2
Andres F Garcia

sie können Swagger-Boostrap-Ui verwenden

github: https://github.com/xiaoymin/Swagger-Bootstrap-UI

unterstützung export markdown von apis und so weiter ...

0
xiaoym

Kasse RapiDoc

  • Unterstützt Theme
  • Kann viele andere Anzeigeattribute wie das Ändern der Headerfarbe, des Headertextes und des Layouts ändern
  • Benutzerdefinierte Elemente, einfach in jedes HTML-Dokument einzufügen. Im Gegensatz zu anderen Lösungen 
0
Mrinmoy