Swagger या Postman से API टेस्टिंग तो पूरी हो जाती थी, लेकिन असली दस्तावेज़ को Notion में अलग से हाथ से
टाइप करना बार-बार करना पड़ता था और यह मुझे दोहरावभरा और अक्षम लगा, इसलिए मैंने यह बनाया।
मैंने क्या बनाया: Swagger/OpenAPI (.json, .yaml), Postman Collection (.json),
या Insomnia Export (.json) में से कोई भी फ़ाइल अपलोड करें, तो यह endpoint/parameter/request·response
examples को व्यवस्थित करके अपने-आप Markdown दस्तावेज़ में बदल देता है। उसे वैसे ही कॉपी करके Notion में पेस्ट
कर सकते हैं, या .md फ़ाइल के रूप में लेकर repo में डाल सकते हैं।
इसे कैसे आज़मा सकते हैं: ऊपर दिए गए लिंक पर जाएँ, तो सीधे upload स्क्रीन खुल जाएगी, और अगर आपके पास
फ़ाइल न भी हो, तो स्क्रीन पर हर format के example file बटन दिए गए हैं, जिन्हें एक क्लिक में दबाकर
तुरंत परिणाम देख सकते हैं।
इसकी खासियत क्या है: मैंने ऐसे मिलते-जुलते टूल देखे थे जो सिर्फ Swagger को support करते हैं, लेकिन
Postman/Insomnia export फ़ाइलों को भी साथ में parse करके एक समान format में बदलने वाला टूल ढूँढना
मुश्किल था, इसलिए मैंने इसी हिस्से को अपनी अलग पहचान बनाया। यह फ़ाइल की सामग्री देखकर अपने-आप तय करता है
कि वह कौन-सा format है।
अभी login फीचर नहीं है, और Insomnia में example response तक नहीं ला पाता जैसी सीमाओं के साथ यह शुरुआती MVP
स्टेज में है। इसे सच में इस्तेमाल करके देखें, और अगर कोई असुविधा लगे या आप चाहें कि ऐसा कोई format भी support
हो, तो बेझिझक कमेंट में बताइए।
मैंने इसे क्यों बनाया, इस बारे में थोड़ा विस्तार से लिखा हुआ लेख यहाँ है:
https://velog.io/@dkslasdud/…
अभी कोई टिप्पणी नहीं है.