Postman: यह क्या है, API परीक्षण और अनुरोधों के साथ काम करना

Postman क्या है और मुख्य विशेषताएं

Postman API विकास और परीक्षण के लिए एक प्लेटफ़ॉर्म है, जो डेस्कटॉप एप्लिकेशन (Windows, macOS, Linux) और वेब संस्करण के रूप में उपलब्ध है। 2012 में Chrome एक्सटेंशन के रूप में बनाया गया, Postman मॉनिटरिंग, mock-सर्वर और क्लाइंट कोड जनरेशन के समर्थन के साथ एक पूर्ण इकोसिस्टम बन गया है।

अनुरोध और प्रतिक्रिया प्रारूप

Postman सभी HTTP मेथड्स का समर्थन करता है: GET, POST, PUT, PATCH, DELETE, HEAD, OPTIONS। अनुरोध का बॉडी JSON, XML, form-data, x-www-form-urlencoded और binary प्रारूपों में हो सकता है। प्रतिक्रिया सिंटैक्स हाइलाइटिंग, Pretty-print और रॉ हेडर देखने की क्षमता के साथ प्रदर्शित होती है।

प्रमाणीकरण समर्थन

अंतर्निहित प्रमाणीकरण प्रकारों में Bearer Token, Basic Auth, Digest Auth, OAuth 1.0, OAuth 2.0, API Key और AWS Signature शामिल हैं। Postman चयनित प्रकार के अनुसार Authorization हेडर स्वचालित रूप से जोड़ देता है, जो टोकन को मैन्युअल रूप से कॉपी किए बिना संरक्षित एंडपॉइंट्स के परीक्षण को तेज़ करता है।

Postman इंटरफेस और नेविगेशन

Postman इंटरफेस में साइड पैनल (Collections, APIs, Environments), कार्य क्षेत्र (Request Builder/Response Viewer) और निचला पैनल (Console, Runner) होता है। Params टैब आपको URL के query-पैरामीटर को टेबल दृश्य में संपादित करने देता है, और Headers टैब HTTP हेडर प्रबंधित करता है।

Postman Console

Console (View → Show Postman Console) सभी नेटवर्क अनुरोधों और प्रतिक्रियाओं को कालानुक्रमिक क्रम में लॉग करता है, जिसमें मध्यवर्ती रीडायरेक्ट और हेडर शामिल हैं। जटिल OAuth फ्लो और रीडायरेक्ट श्रृंखलाओं की डिबगिंग करते समय यह एक अनिवार्य उपकरण है, जब मानक Response Viewer केवल अंतिम परिणाम दिखाता है।

Workspaces और टीम वर्क

Postman Fork और Merge के माध्यम से कलेक्शन वर्जनिंग के साथ टीम वर्कस्पेस का समर्थन करता है। टीम के सदस्य अनुरोधों पर टिप्पणी कर सकते हैं, बदलाव सुझा सकते हैं और रीयल-टाइम में कलेक्शन सिंक कर सकते हैं। Public Workspace आपको बाहरी डेवलपर्स के लिए API दस्तावेज़ीकरण प्रकाशित करने की सुविधा देता है।

HTTP अनुरोध बनाना और भेजना

Postman में बेसिक अनुरोध HTTP मेथड चुनकर और एड्रेस बार में URL दर्ज करके बनाया जाता है। भेजने के बाद, प्रतिक्रिया निचले पैनल में स्टेटस कोड, निष्पादन समय और आकार के साथ प्रदर्शित होती है। अनुरोध पैरामीटर टाइप करते समय स्वचालित रूप से एनकोड होते हैं।

डायनामिक वेरिएबल्स और स्निपेट्स

URL और अनुरोध बॉडी में {{$variable}} प्रारूप के डायनामिक वेरिएबल्स का उपयोग किया जा सकता है। अंतर्निहित वेरिएबल्स {{$guid}}, {{$timestamp}} और {{$randomInt}} प्रत्येक अनुरोध के लिए अद्वितीय मान उत्पन्न करते हैं। कोड स्निपेट्स Code बटन () के माध्यम से उपलब्ध हैं, जो cURL, Python, JavaScript, Kotlin, Swift और अन्य भाषाओं में समतुल्य अनुरोध जनरेट करता है।

// Pre-request में स्क्रिप्ट का उदाहरण: HMAC हस्ताक्षर जनरेशन
const timestamp = Date.now().toString();
const secret = pm.environment.get("api_secret");
const hash = CryptoJS.HmacSHA256(timestamp, secret);
pm.request.headers.add({
    key: "X-Signature",
    value: hash.toString()
});

कलेक्शन और एनवायरनमेंट वेरिएबल्स

कलेक्शन संबंधित अनुरोधों के समूह हैं, जो परियोजना या कार्यात्मक मॉड्यूल के अनुसार संयोजित होते हैं। प्रत्येक कलेक्शन में नेस्टेड फ़ोल्डर, साझा हेडर और Pre-request स्क्रिप्ट हो सकती हैं, जो कलेक्शन के प्रत्येक अनुरोध से पहले चलती हैं। अनुरोधों का क्रम ड्रैगिंग द्वारा निर्धारित किया जाता है।

एनवायरनमेंट वेरिएबल्स और ग्लोबल वेरिएबल्स

Postman वेरिएबल्स के पांच स्तरों का समर्थन करता है: global, collection, environment, data और local। संघर्ष समाधान की प्राथमिकता — स्थानीय से वैश्विक तक। एनवायरनमेंट फ़ाइलों में विभिन्न वातावरणों के लिए key-value जोड़े होते हैं: development, staging, production। एनवायरनमेंट बदलने से सभी URL और टोकन स्वचालित रूप से बदल जाते हैं।

स्क्रिप्ट के माध्यम से API परीक्षण स्वचालित करना

Postman आपको Tests टैब में JavaScript में टेस्ट लिखने की सुविधा देता है, जो प्रतिक्रिया प्राप्त करने के बाद चलते हैं। टेस्ट स्टेटस कोड, प्रतिक्रिया बॉडी, हेडर और निष्पादन समय की जांच करते हैं। परिणाम Test Results पैनल में रंगीन पास इंडिकेटर के साथ प्रदर्शित होते हैं।

pm लाइब्रेरी और अनुरोध चेनिंग

pm ऑब्जेक्ट प्रतिक्रिया के साथ काम करने के तरीके प्रदान करता है: pm.response, pm.expect, pm.variables। अनुरोध चेनिंग एक अनुरोध की प्रतिक्रिया से डेटा को वेरिएबल में सहेजकर और अगले अनुरोध में उपयोग करके लागू की जाती है। यह एकीकरण परीक्षण बनाने और API कॉल के अनुक्रम के माध्यम से व्यावसायिक तर्क की जांच करने का आधार है।

// टेस्ट: प्रतिक्रिया संरचना की जांच और टोकन सहेजना
pm.test("Status code is 200", () => {
    pm.response.to.have.status(200);
});

const json = pm.response.json();
pm.environment.set("auth_token", json.data.token);

Collection Runner और Newman

Collection Runner कलेक्शन के सभी अनुरोधों को क्रमिक रूप से चलाता है, प्रत्येक चरण में टेस्ट निष्पादित करता है। Newman CI/CD पाइपलाइनों (Jenkins, GitHub Actions, GitLab CI) के लिए Postman का कंसोल संस्करण है। Newman मॉनिटरिंग सिस्टम के साथ एकीकरण के लिए JSON, JUnit और HTML प्रारूपों में रिपोर्ट निर्यात करता है।

GraphQL और WebSocket के साथ काम करना

Postman में GraphQL अनुरोध JSON प्रारूप वाले बॉडी के साथ एकल एंडपॉइंट पर POST के माध्यम से भेजे जाते हैं। GraphQL (Beta) टैब सिंटैक्स हाइलाइटिंग, फ़ील्ड ऑटो-कंप्लीशन और स्कीमा के साथ विज़ुअल एडिटर प्रदान करता है। अनुरोध वेरिएबल्स एक अलग Variables पैनल में पास किए जाते हैं।

WebSocket और Socket.IO परीक्षण

Postman संदेश पैनल के साथ एक अलग इंटरफेस के माध्यम से WebSocket कनेक्शन का समर्थन करता है। आप टेक्स्ट और बाइनरी संदेश भेज सकते हैं, कनेक्शन इतिहास देख सकते हैं और डिस्कनेक्ट होने पर स्वचालित रूप से पुनः कनेक्ट कर सकते हैं। Socket.IO क्लाइंट Engine.IO प्रोटोकॉल के साथ संगतता मोड में काम करता है।

// pm API के माध्यम से Postman में WebSocket टेस्ट
const ws = new WebSocket("wss://echo.websocket.org");
ws.onmessage = (event) => {
    pm.test("Echo response received", () => {
        pm.expect(event.data).to.eql("Hello");
    });
};

Postman में Mock-सर्वर और मॉनिटरिंग

Postman के Mock-सर्वर मौजूदा कलेक्शन के आधार पर API एंडपॉइंट्स का अनुकरण करने की सुविधा देते हैं। यह तब उपयोगी है जब बैकएंड अभी तक तैयार नहीं है, लेकिन फ्रंटएंड या मोबाइल ऐप पहले से विकसित किया जा रहा है। Mock-सर्वर सही हेडर और स्टेटस कोड के साथ कलेक्शन से नमूना प्रतिक्रिया लौटाता है।

Mock-सर्वर बनाना

Mock-सर्वर एक क्लिक में कलेक्शन से बनाया जाता है: कलेक्शन चुनें → Mock Servers → Add a new mock server। Postman एक अद्वितीय URL उत्पन्न करता है, जिसका उपयोग वास्तविक API के बजाय एप्लिकेशन कोड में किया जा सकता है। कलेक्शन के प्रत्येक अनुरोध के लिए, मॉक सहेजा गया Example Response लौटाता है, जो बैकएंड पूरा होने से पहले UI की जांच करने की सुविधा देता है।

Postman Monitors के माध्यम से API मॉनिटरिंग

Monitors कलेक्शन को शेड्यूल पर (हर 5 मिनट, घंटे या दिन में) चलाते हैं और API की उपलब्धता और सहीता की जांच करते हैं। टेस्ट विफल होने पर, मॉनिटर ईमेल या Slack पर सूचना भेजता है। मॉनिटरिंग Postman क्लाउड से काम करती है, अलग सर्वर की आवश्यकता नहीं होती है और मुफ्त प्लान पर प्रति माह 10,000 अनुरोधों तक का समर्थन करती है।

// मॉनिटरिंग के लिए टेस्ट: प्रतिक्रिया समय की जांच
pm.test("Response time < 2000ms", () => {
    pm.expect(pm.response.responseTime).to.be.below(2000);
});

pm.test("Content-Type is JSON", () => {
    pm.response.to.have.header("Content-Type");
});

सुरक्षा और सीक्रेट प्रबंधन

Postman API कुंजियों के साथ सुरक्षित काम के लिए तंत्र प्रदान करता है। Secret प्रकार के वेरिएबल एन्क्रिप्टेड होते हैं और इंटरफेस में प्रदर्शित नहीं होते हैं। टीम कार्य के लिए, Admin, Editor और Viewer भूमिकाओं के साथ Workspace का उपयोग करें।

वेरिएबल्स एन्क्रिप्ट करना

एनवायरनमेंट वेरिएबल बनाते समय, Secret प्रकार चुनें — सभी इंटरफेस में मान तारांकन के साथ छिपा होता है। सीक्रेट साझा करते समय कलेक्शन में निर्यात नहीं होते हैं और Newman लॉग में प्रदर्शित नहीं होते हैं। पासवर्ड और टोकन को केवल Secret वेरिएबल्स में संग्रहीत करने की अनुशंसा की जाती है।

Vault एकीकरण

Postman HashiCorp Vault और AWS Secrets Manager के साथ एकीकरण का समर्थन करता है। Pre-request स्क्रिप्ट बाहरी भंडारण से सीक्रेट को गतिशील रूप से अनुरोध कर सकती हैं, जिससे कलेक्शन एनवायरनमेंट फ़ाइलों में संवेदनशील डेटा संग्रहीत करने से बचा जा सकता है।

सुरक्षा और सीक्रेट प्रबंधन

Postman API कुंजियों के साथ सुरक्षित काम के लिए तंत्र प्रदान करता है। Secret प्रकार के वेरिएबल एन्क्रिप्टेड होते हैं और इंटरफेस में प्रदर्शित नहीं होते हैं। टीम कार्य के लिए, Admin, Editor और Viewer भूमिकाओं के साथ Workspace का उपयोग करें।

वेरिएबल्स एन्क्रिप्ट करना

एनवायरनमेंट वेरिएबल बनाते समय, Secret प्रकार चुनें — सभी इंटरफेस में मान तारांकन के साथ छिपा होता है। सीक्रेट साझा करते समय कलेक्शन में निर्यात नहीं होते हैं और Newman लॉग में प्रदर्शित नहीं होते हैं। पासवर्ड और टोकन को केवल Secret वेरिएबल्स में संग्रहीत करने की अनुशंसा की जाती है।

Vault एकीकरण

Postman HashiCorp Vault और AWS Secrets Manager के साथ एकीकरण का समर्थन करता है। Pre-request स्क्रिप्ट बाहरी भंडारण से सीक्रेट को गतिशील रूप से अनुरोध कर सकती हैं, जिससे कलेक्शन एनवायरनमेंट फ़ाइलों में संवेदनशील डेटा संग्रहीत करने से बचा जा सकता है।