Postman Collection
हर कॉन्ट्रैक्ट sandbox URL और उदाहरण रिक्वेस्ट बॉडी के साथ पहले से कॉन्फ़िगर एक Postman कलेक्शन के साथ आता है। कलेक्शन इम्पोर्ट करें, अपने क्रेडेंशियल भरें, और आप बिना कोड लिखे हर एंडपॉइंट को कॉल कर सकते हैं।
कॉन्ट्रैक्ट के अनुसार कलेक्शन
| Contract | Collection | Notes |
|---|---|---|
| Authentication | Download | नीचे दी गई फ़ाइल डाउनलोड करें, इसे Postman में इम्पोर्ट करें, और रिक्वेस्ट टेस्ट करने के लिए "service_account," "tenant_id," और "secret_key" पैरामीटर के मान बदलें। |
| API | Download | प्रोसेस क्रिएशन (POST) और GET process शामिल हैं। |
सेटअप
- आप जिस कॉन्ट्रैक्ट को इंटीग्रेट कर रहे हैं उसके लिए कलेक्शन डाउनलोड करें।
- इसे Postman में इम्पोर्ट करें:
File > Import > Upload Files। - कलेक्शन के अनुसार क्रेडेंशियल कॉन्फ़िगर करें:
Authentication — कलेक्शन खोलें, Variables टैब पर जाएँ, और भरें:
| Variable | Value |
|---|---|
service_account | आपके सर्विस अकाउंट का नाम। |
tenant_id | आपकी टेनेंट ID। |
secret_key | आपकी प्राइवेट key (PEM फ़ॉर्मेट)। |
base_path | टोकन एंडपॉइंट होस्ट। डिफ ़ॉल्ट रूप से UAT (https://identityhomolog.acesso.io); प्रोडक्शन के लिए https://identity.acesso.io में बदलें। |
API — हर रिक्वेस्ट खोलें और Authorization: Bearer तथा APIKEY हेडर वैल्यू को अपने क्रेडेंशियल से बदलें।
- Authentication रिक्वेस्ट चलाएँ — प्री-रिक्वेस्ट स्क्रिप्ट अपने आप JWT असर्शन बनाती है और इसे
{{jwt_token}}में स्टोर करती है।
प्री-रिक्वेस्ट स्क्रिप्ट
केवल Authentication कलेक्शन में एक प्री-रिक्वेस्ट स्क्रिप्ट शामिल है। यह:
- कलेक्शन वेरिएबल से
service_account,tenant_id,secret_key, औरbase_pathपढ़ती है। - एम्बेडेड KJUR लाइब्रेरी का इस्तेमाल करके JWT असर्शन (RS256) बनाती और हस्ताक्षरित करती है।
- हस् ताक्षरित टोकन को
{{jwt_token}}में सेव करती है, जो अपने आप रिक्वेस्ट बॉडी में इंजेक्ट हो जाता है।
API कलेक्शन में कोई प्री-रिक्वेस्ट स्क्रिप्ट नहीं है — क्रेडेंशियल सीधे रिक्वेस्ट हेडर में सेट किए जाते हैं।
आगे क्या
- Authentication — कलेक्शन को चाहिए ऐसे क्रेडेंशियल जनरेट करें।
- API Overview — API कलेक्शन के लिए संदर्भ।