रीप्ले
रीप्ले किसी भी HTTP अनुरोध को बदलकर दोबारा भेजने देता है और हर प्रयास दर्ज करता है, ताकि आप तुलना कर सकें कि बदलाव प्रतिक्रिया पर कैसे असर डालते हैं।
सत्र बनाना
रीप्ले सत्र में एक अनुरोध और उसके प्रयास होते हैं। इसे बनाने के सामान्य तरीके:
- HTTP इतिहास में अनुरोध चुनें और रीप्ले में भेजें चुनें।
- स्वचालन में परिणाम पंक्ति चुनें और रीप्ले में भेजें चुनें।
- रीप्ले खोलकर रॉ अनुरोध पेस्ट या टाइप करने के लिए खाली सत्र बनाएँ।
- API परिभाषा से सत्र बनाने के लिए सत्र टूलबार में आयात करें का उपयोग करें।
प्रत्येक सत्र स्वतंत्र है। अलग-अलग अनुरोधों पर एक साथ काम करने के लिए कई सत्र खोलें।
अनुरोध संपादक
संपादक पूरा HTTP अनुरोध दिखाता है: विधि, URL, हेडर और बॉडी। किसी भी फ़ील्ड को सीधे संपादित करें।
अपने परीक्षण के प्रकार के अनुसार अनुरोध संपादन मोड चुनें:
| टैब | क्या संपादित कर सकते हैं |
|---|---|
| सुव्यवस्थित | सिंटैक्स हाइलाइट वाला HTTP टेक्स्ट और समर्थित होने पर फ़ॉर्मैट की गई बॉडी। फ़ॉर्मैटिंग अनुरोध का हिस्सा तभी बनती है जब आप यह दृश्य संपादित करते हैं। |
| मूल | संपादन योग्य HTTP/1.x वायर टेक्स्ट, जिसमें दिखाई देने वाले CR/LF एस्केप शामिल हैं। गलत फ़्रेमिंग सुधारने के बजाय सटीक बाइट भेजता है। |
| हेक्स | बाइनरी सामग्री सहित पूरे HTTP/1.x अनुरोध का बाइट-स्तरीय संपादन। |
| फ़ॉर्म | बॉडी में समर्थित फ़ॉर्म एन्कोडिंग होने पर फ़ील्ड-आधारित संपादन। |
टूलबार में विधि, HTTP/TLS, लक्ष्य, रीडायरेक्ट, Content-Length, टाइमआउट और कुकी स्रोत के नियंत्रण हैं। क्वेरी पैरामीटर से क्वेरी पैरामीटर जोड़, अक्षम या हटा सकते हैं। कैप्चर की गई बड़ी बॉडी अभी संपादक में लोड न हुई हो तो बॉडी लोड करें का उपयोग करें।
रॉ और हेक्स जानबूझकर वैरिएबल विस्तार, कुकी प्रतिस्थापन, रीडायरेक्ट और मिलान और प्रतिस्थापन नियमों को बायपास करते हैं, ताकि गलत संरचना वाले अनुरोधों के परीक्षण सटीक बाइट बनाए रखें। ये HTTP/1.x ट्रांसपोर्ट हैं, रॉ HTTP/2 फ़्रेम बनाने का तरीका नहीं। सामान्य रीप्ले के लिए संरचित संपादक उपयोग करें। वास्तव में क्या भेजा गया, यह जाँचने के लिए उस अनुरोध से संबंधित प्रयास का रिकॉर्ड देखें।
प्रयास भेजना और तुलना करना
अनुरोध भेजने के लिए भेजें पर क्लिक करें। प्रतिक्रिया दाएँ पैनल में दिखती है। हर भेजा गया अनुरोध संपादक के नीचे प्रयास सूची में एक प्रयास के रूप में सहेजा जाता है।
प्रयास सूची बंद हो तो उसे खोलें। किसी प्रयास को चुनने पर उसी प्रयास का अनुरोध और प्रतिक्रिया लोड होते हैं, केवल नवीनतम प्रतिक्रिया नहीं। प्रयास के नियंत्रणों में स्वचालन में खोलना, एक प्रयास हटाना, CSV निर्यात और प्रयासों को दृश्य से छिपाना शामिल है। छिपाना और हटाना एक ही बात नहीं हैं।
तुलना उपकरण में प्रतिक्रियाओं के अंतर देखने के लिए यह प्रतिक्रिया तुलना उपकरण में खोलें का उपयोग करें। एक बार में केवल एक पैरामीटर बदलें, ताकि दिखने वाला अंतर उसी बदलाव से जोड़ा जा सके।
परिवेश वैरिएबल
परिवेश, कलेक्शन या सत्र वैरिएबल का संदर्भ देने के लिए {{env.VAR}} उपयोग करें। कार्यक्षेत्र के ग्लोबल और प्रोजेक्ट मान परिवेश में परिभाषित करें, फिर स्थानीय ओवरराइड के लिए कलेक्शन या सत्र वैरिएबल उपयोग करें। बॉडी के भीतर विस्तार चाहिए तो बॉडी टेम्पलेटिंग सक्षम करें; अन्यथा उसके बाइट सुरक्षित रहते हैं।
वैरिएबल इन कामों में उपयोगी हैं:
- परीक्षण सत्रों के बीच बदलने वाले टोकन
- पहुँच नियंत्रण जाँचने के लिए बदली जाने वाली खाता ID
- स्टेजिंग और प्रोडक्शन के बीच बदले जाने वाले होस्ट
संरचित भेजने में सबसे विशिष्ट मान को प्राथमिकता मिलती है: सत्र, कलेक्शन, प्रोजेक्ट और फिर ग्लोबल। अनुपस्थित वैरिएबल से त्रुटि आती है। ट्रांसफ़ॉर्म और डायनामिक मानों के लिए परिवेश देखें।
कुकी और रीडायरेक्ट
सत्र का Cookie हेडर बनाए रखने के लिए अनुरोध के हेडर, प्रोजेक्ट कुकी जार की मेल खाने वाली कुकी के लिए कुकी भंडार, या एम्बेडेड ब्राउज़र की मेल खाने वाली कुकी के लिए Ogma ब्राउज़र चुनें। ये विकल्प संरचित भेजने पर लागू होते हैं; रॉ और हेक्स दिए गए बाइट बनाए रखते हैं।
सहेजी गई कुकी प्रबंधित करने के लिए परियोजना का कुकी भंडार संपादित करें उपयोग करें। रीडायरेक्ट का अनुसरण करते समय Ogma अधिकतम 10 का अनुसरण करता है और ओरिजिन बदलने पर Authorization तथा Cookie हेडर हटाता है। ओरिजिन बदलने के बाद प्रमाणीकरण जाँचें, यह न मानें कि क्रेडेंशियल आगे भेज दिए गए।
कलेक्शन
कलेक्शन संबंधित सत्रों को समूह में रखते हैं। किसी विशेष सुविधा या परीक्षण परिदृश्य के सभी अनुरोध व्यवस्थित करने के लिए कलेक्शन बनाएँ।
कलेक्शन-स्तरीय वैरिएबल उसके सभी सत्रों पर लागू होते हैं, इसलिए टोकन हर सत्र के लिए अलग परिभाषित करने के बजाय एक बार परिभाषित करें।
F2 या सत्र के संदर्भ मेनू से सत्र का नाम बदलें। संग्रह में ले जाएँ या ड्रैग और ड्रॉप से सत्र स्थानांतरित करें और कलेक्शन के भीतर उनका क्रम बदलें। कलेक्शन में उप-कलेक्शन हो सकते हैं और उन्हें JSON के रूप में निर्यात या आयात किया जा सकता है। ऊपर वाले बंद करें और नीचे वाले बंद करें ऊर्ध्वाधर सत्र सूची को संदर्भित करते हैं।
API परिभाषाएँ आयात करना
- सत्र टूलबार में आयात करें पर क्लिक करें।
- अपने आप में पूर्ण OpenAPI 3.x दस्तावेज़, Postman v2.1 कलेक्शन, GraphQL इंट्रोस्पेक्शन परिणाम या WSDL दस्तावेज़ चुनें; अधिकतम 10 MB।
- GraphQL इंट्रोस्पेक्शन के लिए पूछे जाने पर HTTP(S) एंडपॉइंट दें।
- भेजने से पहले बने हुए कलेक्शन और अनुरोध जाँचें: लक्ष्य URL, पैरामीटर, बॉडी उदाहरण और प्रमाणीकरण मान आपके परिवेश के लिए बदलने पड़ सकते हैं।
आयात संपादन योग्य अनुरोध बनाता है; स्कैन नहीं चलाता। बाहरी स्कीमा संदर्भ प्राप्त नहीं किए जाते, इसलिए उन्हें इनपुट दस्तावेज़ में बंडल करें। आयात किए गए पथ एंडपॉइंट में भी HTTP इतिहास प्रविष्टि के बजाय API स्पेक स्रोत के साथ दिखते हैं। gRPC रिफ़्लेक्शन समर्थित आयात फ़ॉर्मैट में नहीं है।
अनुक्रम
अनुरोध क्रम पैनल में कम से कम दो मौजूदा रीप्ले सत्र चुनें, अनुक्रम को नाम दें और निष्पादन क्रम तय करें। अनुक्रम वास्तविक अनुरोध भेजता है, इसलिए ज्ञात बेसलाइन अनुरोध उपयोग करें और परिणामी स्थिति जाँचें; केवल पूरा होने को सफलता का प्रमाण न मानें। अनुक्रम बनाना उसके चरणों के बीच प्रमाणीकरण या टोकन निर्भरता अपने आप नहीं खोजता।
स्वचालन में भेजना
जब किसी अनुरोध के अलग रूप बड़े पैमाने पर चलाने हों, तो सत्र से स्वचालन में भेजें चुनें। Ogma पहले से लोड अनुरोध के साथ स्वचालन खोलता है, ताकि आप पेलोड सूचियाँ परिभाषित करके अभियान चला सकें।
WebSocket रीप्ले
WebSocket रीप्ले अलग दृश्य है जिसमें कनेक्शन स्थिति और भेजे तथा प्राप्त संदेशों की टाइमलाइन होती है। WebSocket इतिहास में WS रीप्ले में भेजें उपयोग करें, कनेक्ट करें और बदले हुए फ़्रेम का परीक्षण करने से पहले आवश्यक एप्लिकेशन-स्तरीय आरंभीकरण या प्रमाणीकरण संदेश भेजें। WebSocket रीप्ले देखें।
AI सहायता
चुने गए आदान-प्रदान के विश्लेषण का अनुरोध करने के लिए प्रतिक्रिया पर AI से विश्लेषण करें उपयोग करें। सुझाए गए परीक्षण और व्याख्याएँ जाँचें; सहायक का स्पष्टीकरण किसी कमज़ोरी का स्वतंत्र प्रमाण नहीं है।