स्वैगर प्रलेखन को साझा करने के लिए कैसे करें

Question

मैंने हाल ही में अपने दस्तावेज़ों के लिए स्वैगर का उपयोग शुरू किया लेकिन कुछ ऐसी चीजें हैं जो अभी भी मेरे लिए अस्पष्ट हैं। मैंने अपना वाईएएमएल दस्तावेज़ बनाया और अब मैं अपनी पीडीएफ को अपनी पीडीएफ या एचटीएमएल/जावास्क्रिप्ट पेज में अपनी बाकी टीम के साथ साझा करने में सक्षम होना चाहता हूं। मैं SwaggerHub का उपयोग नहीं कर सकता क्योंकि उनके पास निजी भंडार नहीं हैं और स्वैगर संपादक पैनल को दाईं ओर साझा करने की अनुमति नहीं देता है।

मैं क्या याद आ रही है:

बस स्पष्ट होना, मैं की तरह कुछ पाने के लिए सक्षम होने के लिए चाहते हैं?

Answer 1

मैं पक्षपाती मैं swaggerhub पर काम के रूप में कर रहा हूँ, लेकिन उस के लिए क्या परियोजना है:

https://swaggerhub.com

वहाँ से, आप अपने अकड़ चश्मा स्वचालित रूप से GitHub करने के लिए धक्का है और यह भी पर अन्य उपयोगकर्ताओं सहयोगियों कर सकते हैं एपीआई (या सिर्फ पढ़ने के लिए)।

Answer 2

DynamicApis.com एक नया एपीआई पोर्टल है जो ऊपर और आने वाला है और उनके पास एक शानदार एकीकरण गाइड है जिसे आप अपने स्वैगर JSON का उपयोग करके मुफ्त में बना सकते हैं। https://www.dynamicapis.com/app/quickguide देखें। यहां एक उदाहरण है कि मेरा एक दोस्त उत्पन्न हुआ। http://bit.ly/1RIVvGN।

वे आपको गिटहब जैसे अपना एपीआई पोर्टल बनाने की अनुमति देते हैं और आपको अपने एपीआई के लिए एक शानदार यूआई उत्पन्न करने के लिए अपने स्वैगर 2.0 दस्तावेज़ अपलोड करने देते हैं। आप यूआई को देखने के लिए अपनी साइट पर जा सकते हैं और कुछ उदाहरण पोर्टल देख सकते हैं।

वे आपके एकीकरण गाइड के लिए bit.ly लिंक उत्पन्न करते हैं ताकि आप लोगों के साथ साझा कर सकें।

आशा है कि इससे मदद मिलती है!