रीस्टफुल एपीआई स्वैगर

Question

के साथ टेस्टबेड मैं एक आरईएसटी एपीआई के लिए एक स्वचालित परीक्षण सूट विकसित करने की कोशिश कर रहा हूं। मुझे बताया गया है कि ऐसा करने के लिए स्वैगर का उपयोग करने का सही टूल होगा। एपीआई स्प्रिंग फ्रेमवर्क का उपयोग करके विकसित किया जा रहा है।

मैं यह नहीं समझ सकता कि मैं ऐसा करने के लिए स्वैगर का उपयोग कैसे करूंगा। मेरी समझ से स्वैगर का उपयोग अच्छा एपीआई दस्तावेज बनाने के लिए किया जाता है। मैंने this Dreamfactory blog post पर देखा है और ऐसा लगता है कि उन्हें कुछ प्रकार की ब्राउज़र परीक्षण कार्यक्षमता मिली है, लेकिन मुझे लगता है कि यह वास्तव में एक परीक्षण सूट नहीं है।

मैंने सर्विसस्टैक (और ककड़ी) पर भी एक नज़र डाली है, लेकिन इसकी एक और ढांचा के बाद से मुझे नहीं लगता कि यह काम करेगा।

This Google समूह चर्चा विशेष रूप से कहीं भी इंगित करने के लिए नहीं देखी गई थी।

तो, क्या कोई जानता है कि स्वैगर का उपयोग करके एक विश्वसनीय एपीआई टेस्टबेड कैसे विकसित किया जाए?

धन्यवाद!

Answer 1

स्वैगर आपको अपने एपीआई को अच्छी तरह से दस्तावेज करने देगा, और आपको मैन्युअल, स्वैगर-यूई के साथ लाइव परीक्षण करने में मदद करेगा, जिसमें आप आसानी से तर्क भर सकते हैं और वेब UI के माध्यम से प्रतिक्रिया देख सकते हैं। मैं जिस चीज का जिक्र कर रहा हूं उसका एक उदाहरण के रूप में स्वैगर डेमो आज़माएं। http://petstore.swagger.io/

मैंने यह कोशिश नहीं की है, लेकिन यह स्वैगर परिभाषाओं के खिलाफ अधिक स्वचालित परीक्षण के लिए रुचि का हो सकता है। https://github.com/Maks3w/SwaggerAssertions

Answer 2

आप (स्वचालित) http://swagger.io/commercial-tools/ पर अपने बाकी एपीआई के परीक्षण के लिए स्वैगर विनिर्देश का उपयोग कर सॉफ्टवेयर का एक बहुत कुछ मिल सकता है। लेकिन वे स्वतंत्र नहीं हैं।

Answer 3

पोस्टमैन स्वैगर एपिस के साथ परीक्षण करने के लिए एक महान उपकरण है। यह अनुरोध और प्रतिक्रिया भी संग्रहीत कर सकता है। https://www.getpostman.com/docs/importing_swagger के रूप में अधिक जानकारी।

आप इस पृष्ठ पर भाषाओं के अनुसार समुदाय टूल को भी देखना चाहेंगे। http://swagger.io/open-source-integrations/

Answer 4

जैसा कि अन्य उत्तरों ने उल्लेख किया है, Swagger आपके एपीआई एंडपॉइंट्स, विधियों, प्रतिक्रियाओं, त्रुटियों आदि को परिभाषित करने और दस्तावेज करने का एक तरीका प्रदान करता है। यह बॉक्स से बाहर स्वचालित परीक्षण का कोई भी प्रकार करता है।

कुछ उपकरण है कि बनाया स्वचालित परीक्षण करने के लिए एक स्वैगर परिभाषा पढ़ सकते हैं, हालांकि इस प्रकार हैं:

• Assertible जहां अपने आप हर के लिए परीक्षण और दावे बनाने के लिए अपने स्वैगर कल्पना आयात कर सकते हैं एक नि: शुल्क उपकरण है एंडपॉइंट और विधि। फिर आप निगरानी, ​​पोस्ट तैनाती परीक्षण, और अलर्ट सेट अप कर सकते हैं। (ब्लॉग Testing an API using Swagger पढ़ें)।
• swagger-test एक एनपीएम पैकेज है, यदि आप अपने कोड के साथ एकीकृत करने के लिए कुछ ढूंढ रहे हैं। मैंने व्यक्तिगत रूप से इसका उपयोग नहीं किया है, लेकिन यह सक्रिय और उपयोगी दिखता है।
• Dredd एक और वास्तव में अच्छा ओपन-सोर्स टूल है जो आपके बैकएंड के खिलाफ अपने स्वैगर स्पेक का परीक्षण स्वचालित करेगा। यह भी एक सीएलआई भी है, और यह API Blueprint in addition to Swagger के साथ काम करता है।

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

swagger.io पर Commercial Tools पृष्ठ को देखने के लिए एक अन्य उत्तर का उल्लेख किया गया है, जिसमें कुछ और होस्टेड सेवाएं (मुफ़्त और भुगतान) हैं।

पूर्ण प्रकटीकरण - मैं असुरक्षित के सह-संस्थापकों में से एक हूं और यदि आपको इसका उपयोग करने का मौका मिलता है तो आपकी प्रतिक्रिया सुनना अच्छा लगेगा!