2015-01-19 19 views
46

Restful API'lerini belgelemek için özellikle "Try it out!" düğmesi, ancak swagger-ui arayüzü çok havalı görünmüyor.Neden swagger-ui için tema yok?

Böyle inanılmaz açık kaynak kodlu bir araç için şablon olmadığını düşünmüyorum (veya bulamıyorum)?

Bunu ücretsiz olarak istemiyorum .. Beğen http://getbootstrap.com/ Temaları (https://wrapbootstrap.com/ gibi) satın almak için pek çok siteye sahip, neden bulamadık temalar için herhangi bir site bulamıyorum?

+0

Swagger'ın bir sonraki seviyeye gelmesini görmek için https://www.dynamicapis.com adresini ziyaret edin. Swagger belgelerinizi alıp harika görünümlü bir kullanıcı arayüzü oluşturuyorlar. İşte onlar tarafından barındırılan bir API portalının bir örneği: https://www.dynamicapis.com/dapi/apis/0b971e55-c61f-4428-a65f-ca905bd52762 –

cevap

57

Geç bir cevap, iyi bir tane de olsa. Bu oldukça harika! Kaygan bir uygulama ve ihtiyaçlarınız için tekrar çim biçme kolaylığı olan birçok şeyi özelleştirdi: https://github.com/jensoleg/swagger-ui.

Krediler bu google grubuna git: https://groups.google.com/forum/#!topic/swagger-swaggersocket/oeMyayrvKRI. Bunun henüz buraya gönderilmemesi garip. Bir eylem Demo için

, bu bağlantıyı kontrol edin: http://senodio.com/site/swagger/#!/pet/addPet

-

DÜZENLEME: Son DEMO aşağı olduğunu gördük, bu yüzden Repo (https://github.com/MartinSahlen/swagger-ui) çatallı ve yaratılan Heroku üzerinde çalışan basit düğüm/hızlı sunucu. Bu ücretsiz bir kahraman dyno olduğunu unutmayın, bu yüzden bir süre için düşük aktivite varsa (~ 20 saniye) yüklemek için biraz zaman alabilir.

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

DÜZENLEME 2: https://github.com/legendecas/material-swagger-ui : Sadece umut verici görünüyor başka bir geldi. Aynı zamanda şu anda barındıran havalı kullanıcı arayüzünün http://swaggerui.herokuapp.com/ adresinde yeniden dirildiği görülüyor. Yine aşağı çekilirse benimkini de koru.

+0

vay. Güzel. Teşekkür ederim! –

+1

Sadece bir başlık: Aksiyon demo bağlantınızın bitmiş gibi görünüyor. –

+0

Evet, biliyorum. Çok uzun sürmezse, barındırmak için basit bir heroku uygulaması eklemeyi deneyeceğim. –

4

Swagger-UI, yeni bir araç olmamakla birlikte, görevine çok özgüdür. Bunun için temalar sağlayan herhangi bir web sitesinden habersiz (ücretsiz veya ücretli). Kullanıcılarının çoğu, kullanıcı arayüzünü yerel temalarına uyacak şekilde özelleştirmiştir. Bazıları ince değişiklikler yaptı, bazıları tam bir revizyon yaptı.

Mevcut uygulamalara göz atmanızı ve gereksinimlerinize uygun bir şey olup olmadığını görmenizi öneririz. O zaman belki de kendi teması için kendi temasını/şablonunu yeniden kullanma izni isteyin.

+0

Tamam, teşekkürler, ama bu uygulamaları bulmak imkansız olduğunu düşünüyorum. . –

+1

Burada (çok) kısmi bir liste bulabilirsiniz - https://github.com/swagger-api/swagger-spec/wiki/Sites-and-Services. – Ron

+0

Tekrar teşekkürler! –