AI API स्पेसिफ़िकेशन → टेस्ट केस कैसे इस्तेमाल करें
- टूल खोलें और कोई OpenAPI अंश या अपने endpoints का विवरण पेस्ट करें।
- चाहें तो संदर्भ जोड़ें (फ़ीचर का विवरण, acceptance criteria, environment) — इनपुट जितना ठोस होगा, नतीजा उतना ही बेहतर आएगा।
- विकल्प चुनें (संख्या, आउटपुट भाषा, फ़ोकस) और ऐक्शन बटन दबाएँ।
- तालिका में संरचित नतीजा देखें, फिर उसे Markdown, CSV या JSON के रूप में कॉपी या डाउनलोड करें।
AI API स्पेसिफ़िकेशन → टेस्ट केस की खूबियाँ
- OpenAPI 3 / Swagger 2 के अंश (JSON या YAML) और सादे endpoint विवरण — दोनों समझता है
- हर operation के लिए request (method, path, headers, query, body), अपेक्षित status और assertions सहित केस
- फ़ोकस चयन: all, positive, negative, auth, boundary या security
- पहचाने गए operations की तालिका के साथ Markdown/CSV/JSON एक्सपोर्ट
- जनरेट होने वाले टेक्स्ट की भाषा चुनें — English, Arabic या Hindi; identifiers, HTTP methods और तकनीकी टोकन हमेशा English में ही रहते हैं।
AI API स्पेसिफ़िकेशन → टेस्ट केस का उदाहरण
Spec → API टेस्ट
इनपुट:
DELETE /lookups/{lookup}/values/{id} → 204 / 403 / 409आउटपुट:
API-1 Delete unreferenced value → 204
API-2 Delete as Viewer → 403
API-3 Delete referenced value → 409 with reference count
…AI API स्पेसिफ़िकेशन → टेस्ट केस के बारे में अक्सर पूछे जाने वाले सवाल
क्या इसके लिए पूरी OpenAPI फ़ाइल ज़रूरी है?
नहीं। कुछ paths वाला अंश या endpoints का सादा-टेक्स्ट विवरण भी काम कर जाता है; AI उन operations की सूची दिखाता है जो उसने पहचाने, ताकि आप दायरे की पुष्टि कर सकें।
क्या मेरा इनपुट संग्रहित किया जाता है?
नहीं। आपका टेक्स्ट Mutqan बैकएंड के ज़रिए Mutqan AI को भेजा जाता है और संरचित नतीजा आपके ब्राउज़र में लौटा दिया जाता है। हम prompt या आउटपुट संग्रहित नहीं करते — सिर्फ़ दैनिक सीमाओं के लिए इस्तेमाल होने वाले गुमनाम उपयोग काउंटर रखे जाते हैं।
मैं कितनी बार जनरेट कर सकता हूँ?
गुमनाम विज़िटर को हर नेटवर्क एड्रेस के हिसाब से छोटी दैनिक सीमा मिलती है; रजिस्टर्ड यूज़र को उससे ज़्यादा दैनिक कोटा मिलता है। बची हुई संख्या हर नतीजे के नीचे दिखाई जाती है।
क्या नतीजा Arabic या Hindi में मिल सकता है?
हाँ — आउटपुट भाषा चुन लें। स्वाभाविक भाषा वाले फ़ील्ड उसी भाषा में लिखे जाते हैं, जबकि identifiers, HTTP methods, paths और दूसरे तकनीकी टोकन English में ही रहते हैं।
तकनीकी नोट्स
आपका इनपुट एन्क्रिप्टेड कनेक्शन के ज़रिए Mutqan बैकएंड से होते हुए Mutqan AI को भेजा जाता है; prompt और नतीजे कभी संग्रहित नहीं किए जाते — सिर्फ़ rate limiting के लिए इस्तेमाल होने वाले गुमनाम उपयोग काउंटर रखे जाते हैं।
AI को सख़्त JSON में ही जवाब देना होता है, जिसे कुछ भी दिखाने से पहले सर्वर पर एक schema के विरुद्ध जाँचा जाता है; ख़राब जवाब एक बार दोबारा माँगा जाता है और उसके बाद साफ़ संदेश के साथ अस्वीकार कर दिया जाता है।
AI कभी ऐसे endpoints नहीं गढ़ता जो contract में मौजूद नहीं हैं; जहाँ spec अस्पष्ट हो, वहाँ notes फ़ील्ड में की गई धारणा दर्ज कर दी जाती है।