इस लिस्टिंग के बारे में
जहाँ अधिकांश API दस्तावेज़ीकरण विफल हो जाता है
कई गाइड एंडपॉइंट्स की सूची तो देते हैं, लेकिन उन विवरणों को छोड़ देते हैं जो वास्तव में भ्रम पैदा करते हैं: प्रमाणीकरण व्यवहार में कैसे काम करता है, सटीक अनुरोध और प्रतिक्रिया के उदाहरण, और विशिष्ट त्रुटियों का क्या अर्थ है तथा उनका समाधान कैसे किया जाए। जब ऐसा होता है, तो डेवलपर्स सहायता टिकट जमा करने का सहारा लेते हैं, जिससे दस्तावेज़ीकरण होने का उद्देश्य ही समाप्त हो जाता है।
हमारा दृष्टिकोण
हम अनुमानों पर भरोसा करने के बजाय सीधे आपके सोर्स कोड से निर्माण करते हैं। हम लाइव क्रेडेंशियल्स का उपयोग करके स्वयं API का परीक्षण करने से पहले आपके रूट्स, सत्यापन तर्क और त्रुटि प्रबंधन का निरीक्षण करते हैं। अंतिम दस्तावेज़ में प्रत्येक उदाहरण हमारे द्वारा भेजे गए वास्तविक अनुरोध और प्राप्त प्रतिक्रिया का प्रतिनिधित्व करता है, जिससे यह सुनिश्चित होता है कि कोई भी मनगढ़ंत विवरण या असंभव स्टेटस कोड न हो।
आपको क्या प्राप्त होता है
- प्रमाणीकरण मार्गदर्शन: टोकन जारी करना, रीफ्रेश करना, और यदि सत्र के मध्य में यह समाप्त हो जाता है तो क्या होता है।
- प्रत्येक एंडपॉइंट का पूर्ण कवरेज, जिसमें पैरामीटर, एक कार्यशील उदाहरण अनुरोध और वास्तविक प्रतिक्रिया संरचना शामिल है।
- एक त्रुटि संदर्भ जो प्रत्येक कोड को उसके कारण और समाधान से जोड़ता है, न कि केवल दोहराया गया संदेश।
- एक त्वरित-प्रारंभ पथ जो एक नए डेवलपर को शून्य से सफल कॉल तक ले जाने के लिए डिज़ाइन किया गया है।
- जहाँ भी प्रासंगिक हो, दर सीमा, पेजिनेशन, वेबहुक और आइडम्पोटेंसी पर नोट्स।
वितरण प्रारूप
हम आपके रिपॉजिटरी के अनुकूल Markdown प्रदान करते हैं, जिसे इस प्रकार संरचित किया गया है कि यह OpenAPI या किसी दस्तावेज़ीकरण साइट में फिट बैठता है, जिसे भी आपकी टीम अपडेट रखेगी। कोड उदाहरण उन भाषाओं में प्रदान किए जाते हैं जिन पर आपके उपयोगकर्ता भरोसा करते हैं और उन्हें चलाकर परीक्षण किया जाता है। अनुरोध पर एक Postman-शैली संग्रह शामिल किया जा सकता है।
हमें आपसे क्या चाहिए
आपके रिपॉजिटरी या OpenAPI फ़ाइल तक पहुँच, परीक्षण वातावरण के लिए एक कार्यशील क्रेडेंशियल, और वे प्रश्न जिनका उत्तर आपके सहायता कर्मचारी सबसे अधिक बार देते हैं - ये गाइड की संरचना को आकार देते हैं।
क्या शामिल नहीं है
यह सेवा सॉफ्टवेयर के व्यवहार के सटीक तकनीकी दस्तावेज़ीकरण को कवर करती है; प्रचार या विपणन पाठ्य सामग्री एक अलग कार्य है।
प्रक्रिया और समय सीमा
आपको एक संपूर्ण पहला मसौदा प्राप्त होगा, जिसे आप अपनी सहायता टीम द्वारा सामना किए जाने वाले आवर्ती प्रश्नों के आधार पर जाँच सकते हैं। हम इसके बजाय पसंद करेंगे कि कोई इंजीनियर किसी असाधारण स्थिति को पहले ही चिह्नित कर दे, न कि कुछ ऐसा सौंपे जो परिष्कृत तो हो लेकिन गलत हो। चूँकि प्रत्येक उदाहरण को आपके लाइव API के विरुद्ध चलाया गया है, इसलिए अंतिम दस्तावेज़ में कुछ भी सैद्धांतिक नहीं है।
यह पैकेज 500.99 USD और 10 दिनों की समय सीमा के लिए संशोधन के एक दौर के साथ, एक ही बार में वितरित किए गए एक निश्चित-मूल्य वाले API दस्तावेज़ीकरण कार्यक्षेत्र को कवर करता है। आपको वह डोमेन प्रदान करना होगा जिससे ऑर्डर संबंधित है और आपका संक्षिप्त विवरण।