Swagger belgeleri nasıl paylaşılır

Question

Kısa bir süre önce belgelerim için Swagger'ı kullanmaya başladım, ancak hala benim için net olmayan birkaç şey var. YAML belgesini oluşturdum ve şimdi dokümanlarımı ekibimin geri kalanıyla bir .pdf veya HTML/Javascript sayfasında paylaşmak istiyorum. SwaggerHub kullanamıyorum çünkü özel depoları yok ve Swagger Editor sağdaki paneli paylaşmaya izin vermiyor gibi görünüyor. Ben ne eksik

:

Daha açıkçası, ben gibi bir şey elde edebilmek istersiniz?

Answer 1

ben swaggerhub üzerinde çalışırken önyargılı değilim, ama bunun için proje budur: Oradan, github için otomatik dayı özelliklerini itmek ve aynı zamanda diğer kullanıcıların işbirlikçilerini yapabilirsiniz

https://swaggerhub.com

API (veya sadece salt okunur).

Answer 2

DynamicApis.com, yeni bir API portalı olup, Swagger JSON'unuzu kullanarak ücretsiz olarak oluşturabileceğiniz harika bir entegrasyon rehberine sahiptir. https://www.dynamicapis.com/app/quickguide'a bakın. İşte bir arkadaşımın oluşturduğu bir örnek. http://bit.ly/1RIVvGN.

Ayrıca, GitHub gibi API portalınızı oluşturmanıza ve API'larınız için harika bir kullanıcı arayüzü oluşturmak için Swagger 2.0 belgelerinizi yüklemenize izin verir. Siteye gidebilir ve kullanıcı arayüzünü görmek için bazı örnek portallara gidebilirsiniz.

Entegrasyon kılavuzlarınız için kullanıcılarla paylaşabileceğiniz böylelikle bağlantılar oluştururlar.

Bu yardımcı olur umarız!