OpenAPI → टेस्ट केस कैसे इस्तेमाल करें
- स्पेसिफ़िकेशन पेस्ट करें (या उदाहरण लोड करें)।
- चाहें तो कुछ ख़ास operation तक सीमित करें और अपनी ज़रूरत की श्रेणियाँ चुनें।
- एक्सपोर्ट फ़ॉर्मैट चुनें और टेस्ट केस बनाएँ।
- तालिका देखें, फिर अपने टेस्ट-मैनेजमेंट टूल के लिए एक्सपोर्ट कॉपी या डाउनलोड करें।
OpenAPI → टेस्ट केस की खूबियाँ
- OpenAPI 3.x और Swagger 2.0 को JSON या YAML में पार्स करता है और लोकल $ref हल करता है
- हर operation के लिए happy-path, ज़रूरी फ़ील्ड ग़ायब, अमान्य type, boundary, auth, not-found, दस्तावेज़ित error, method और content-type केस बनाता है
- path/query पैरामीटर और बॉडी के लिए यथार्थवादी सिंथेटिक वैल्यू वाले उदाहरण रिक्वेस्ट
- हर केस पर प्राथमिकता, पूर्व-शर्तें, चरण, अपेक्षित स्टेटस और अपेक्षित नतीजा
- operation और श्रेणी से फ़िल्टर करें; Markdown, JSON या CSV में एक्सपोर्ट करें
OpenAPI → टेस्ट केस का उदाहरण
किताब बनाने वाला endpoint
इनपुट:
POST /books with required body { title, isbn (^[0-9]{13}$), price 0–10000 } and bearer securityआउटपुट:
TC-003 Create a book — valid request succeeds (201)
TC-004 Create a book — body without required field "title" (400)
TC-007 Create a book — wrong type for body field "price" (number → "abc") (400)
TC-011 Create a book — body "price" at above maximum (10001) (400)
TC-015 Create a book — no credentials (401)
TC-018 Create a book — duplicate create (409)OpenAPI → टेस्ट केस के बारे में अक्सर पूछे जाने वाले सवाल
कौन-से टेस्ट केस बनते हैं?
हर operation के लिए: happy path, वैकल्पिक पैरामीटर छोड़े जाने पर, ज़रूरी पैरामीटर और बॉडी फ़ील्ड ग़ायब होने पर, अमान्य type, boundary वैल्यू (min/max, लंबाई, आइटम की संख्या), बिना प्रमाणीकरण या निषिद्ध पहुँच, अनजान id (404), दस्तावेज़ित error स्टेटस, असमर्थित method (405) और असमर्थित content type (415)।
क्या मैं सिर्फ़ एक operation पर ध्यान दे सकता हूँ?
हाँ — method, path, operationId, summary या tag से फ़िल्टर करें (जैसे "POST /books" या "createBook") और अपनी ज़रूरत की श्रेणियाँ चुनें।
मैं किन फ़ॉर्मैट में एक्सपोर्ट कर सकता हूँ?
Markdown (wiki या PR के लिए तैयार), JSON (टूलिंग के लिए) और CSV (स्प्रेडशीट या टेस्ट-मैनेजमेंट में इम्पोर्ट के लिए)। तालिका भी CSV में डाउनलोड की जा सकती है।
क्या यह Swagger 2.0 सपोर्ट करता है?
हाँ। OpenAPI 3.x के साथ-साथ Swagger 2.0 के body पैरामीटर, definitions और securityDefinitions भी संभाले जाते हैं।
तकनीकी नोट्स
boundary केस minimum/maximum, exclusive सीमाओं, minLength/maxLength और maxItems से निकाले जाते हैं; जब किसी संख्यात्मक फ़ील्ड पर कोई सीमा न हो, तो शून्य, ऋणात्मक और बहुत बड़ी वैल्यू सुझाई जाती हैं। सुरक्षा operation-स्तर या वैश्विक security आवश्यकताओं से पढ़ी जाती है।