2015-01-19 7 views
46

Ich mag Swagger für die Dokumentation von Restful APIs, besonders "Probieren Sie es aus!" Knopf, aber swagger-ui Schnittstelle sieht nicht sehr cool aus.Warum gibt es keine Themen für Swagger-Ui?

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

Ich will es nicht kostenlos .. Wie http://getbootstrap.com/ hat viele Websites, Themen (wie https://wrapbootstrap.com/) zu kaufen, warum kann ich keine Website für swagger Themen finden?

+0

Wenn Sie Swagger auf die nächste Ebene gebracht haben möchten, besuchen Sie https://www.dynamicapis.com. Sie nehmen Ihre Swagger-Dokumente und erzeugen eine fantastisch aussehende Benutzeroberfläche. Hier ist ein Beispiel für ein von ihnen gehostetes API-Portal: https://www.dynamicapis.com/dapi/apis/0b971e55-c61f-4428-a65f-ca905bd52762 –

Antwort

57

Eine späte Antwort, wenn auch eine gute Antwort. Das ist ziemlich toll! Eine raffinierte Implementierung, und er hat viele Dinge angepasst, die einfach noch einmal für Ihre Bedürfnisse optimiert werden können: https://github.com/jensoleg/swagger-ui.

Credits gehen zu dieser Google-Gruppe: https://groups.google.com/forum/#!topic/swagger-swaggersocket/oeMyayrvKRI. Seltsam, dass das hier noch nicht gepostet wurde.

Für eine Aktion Demo, überprüfen Sie bitte diesen Link: http://senodio.com/site/swagger/#!/pet/addPet

-

EDIT: Vor kurzem fand, dass die DEMO nach unten, so gegabelt ich den Repo (https://github.com/MartinSahlen/swagger-ui) und erstellt ein einfacher Knoten/Express-Server, der auf Heroku läuft. Bitte beachten Sie, dass es sich hierbei um einen kostenlosen Heroku-Prüfstand handelt. Es kann also eine Weile dauern, bis der Ladevorgang abgeschlossen ist (~ 20 Sekunden), wenn die Aktivität für einige Zeit gering ist.

Sie sind willkommen: http://sleepy-harbor-80783.herokuapp.com/#!/pet/addPet

EDIT 2: Nur über eine andere kam, die vielversprechend aussieht: https://github.com/legendecas/material-swagger-ui . Es scheint auch, dass der Swagger, den ich jetzt hosse, bei http://swaggerui.herokuapp.com/ wieder auferstehen wird. Halte meine auch, falls es wieder abgebaut wird.

+0

wow. nett. Vielen Dank! –

+1

Nur ein Heads-Up: Es sieht so aus, als ob dein Aktionsdemo-Link tot ist. –

+0

Ja, ich weiß. Wird versuchen, eine einfache Heroku-App hinzuzufügen, um es zu hosten, wenn es nicht zu lange dauert. –

4

Obwohl Swagger-UI kein neues Werkzeug ist, ist es sehr spezifisch für seine Aufgabe. Ich kenne keine Website, die Themen dafür bietet (kostenlos oder kostenpflichtig). Viele Benutzer haben die Benutzeroberfläche an ihr lokales Thema angepasst. Einige haben subtile Änderungen vorgenommen, andere eine komplette Überarbeitung.

Ich würde empfehlen, sich die verfügbaren Implementierungen anzusehen und zu prüfen, ob etwas Ihren Anforderungen entspricht. Dann bitten Sie vielleicht um Erlaubnis, ihr Thema/Vorlage für Ihre eigenen Bedürfnisse wiederzuverwenden.

+0

Ok, danke, aber ich denke, es ist unmöglich, diese Implementierungen zu finden. . –

+1

Hier finden Sie eine (sehr) unvollständige Liste - https://github.com/swagger-api/swagger-spec/wiki/Sites-and-Services. – Ron

+0

Nochmals vielen Dank! –

Verwandte Themen