एपीआई Postman के लिए दिशा-निर्देश

Postman, कारोबारी या कंपनी को Merchant API को टेस्ट करने और समझने की सुविधा देता है. साथ ही, यह एचटीटीपी अनुरोधों को बनाने, भेजने, और उनका विश्लेषण करने के लिए, इस्तेमाल में आसान इंटरफ़ेस उपलब्ध कराता है. अलग-अलग एंडपॉइंट के लिए, एपीआई कॉल (GET, POST, PUT, DELETE) आसानी से बनाए और उनमें बदलाव किए जा सकते हैं. साथ ही, पैरामीटर, हेडर, और अनुरोध के मुख्य हिस्से में बदलाव करके, असली दुनिया के उदाहरणों को सिम्युलेट किया जा सकता है.

यह टूल, स्टेटस कोड, हेडर, और पेलोड के साथ जवाबों को साफ़ तौर पर दिखाता है. इससे एपीआई के काम करने के तरीके की तुरंत पुष्टि की जा सकती है. साथ ही, समस्याओं को डीबग करने में मदद मिलती है. इस स्ट्रक्चर्ड अप्रोच से, डेवलपमेंट प्रोसेस को तेज़ी से पूरा किया जा सकता है. साथ ही, एपीआई की क्वालिटी को बेहतर बनाया जा सकता है. इसके अलावा, Merchant API की क्षमताओं और बारीकियों को बेहतर तरीके से समझा जा सकता है.

खास जानकारी

अपने Postman इंस्टेंस पर MAPI Postman कलेक्शन का इस्तेमाल करने के लिए, आपको पहले एनवायरमेंट को कॉन्फ़िगर करने के लिए कुछ चरणों का पालन करना होगा. इसके लिए, यहां सिलसिलेवार निर्देश दिए गए हैं.

प्लैटफ़ॉर्म के बारे में ज़्यादा जानने के लिए, Postman का ब्यौरा देखें.

1. सेवा खाते का कॉन्फ़िगरेशन

आपको serviceAccountKey और api_key मिलेगा

1. ज़्यादा जानकारी के लिए, एपीआई को ऐक्सेस करने के लिए सेवा खाते का इस्तेमाल कैसे करें लेख पढ़ें
2. अपने Google Cloud Project > क्रेडेंशियल > क्रेडेंशियल बनाएं > सेवा खाता पर जाएं
3. फ़ॉर्म भरें और बनाएं और जारी रखें पर क्लिक करें
4. मालिक की भूमिका चुनें और जारी रखें पर क्लिक करें
5. हो गया पर क्लिक करें
6. JSON कुंजी डाउनलोड करने के लिए, यह तरीका अपनाएं:
   1. अभी बनाए गए सेवा खाते के ईमेल पते पर क्लिक करें. यह कुछ इस तरह का होगा: {YOUR_SERVICE_ACCOUNT}@{RANDOM_DOMAIN}.gserviceaccount.com
   2. कुंजियां टैब पर क्लिक करें
   3. कुंजी जोड़ें > कुंजी बनाएं पर क्लिक करें
   4. JSON फ़ाइल डाउनलोड करने के लिए, JSON चुनें और बनाएं पर क्लिक करें

चेतावनी: पासकोड को सिर्फ़ एक बार डाउनलोड किया जा सकता है. अगर यह खो जाता है, तो आपको एक नया पासकोड बनाना होगा और इसे मिटाना होगा

1. Merchant Center खोलें
2. सेटिंग > ऐक्सेस और सेवा में जाकर, लोग और ऐक्सेस पर क्लिक करें
3. व्यक्ति जोड़ें पर क्लिक करें और नए उपयोगकर्ता के लिए, सेवा खाते के आईडी को ईमेल पते के तौर पर इस्तेमाल करें.

2. Postman सेट अप करना

1. Postman Environment template JSON डाउनलोड करें
2. MAPI Postman collection JSON डाउनलोड करें
3. Postman में साइन इन करें या नया खाता बनाएं
4. Postman एनवायरमेंट टेंप्लेट इंपोर्ट करना
   1. अपने पूरे JSON को Environment > MyAccount > serviceAccountKey में कॉपी करें
   2. JSON से अपनी private_key को कॉपी करें और इसे कलेक्शन के Environment > MyAccount > api_key में चिपकाएं
5. MAPI Postman Collection JSON इंपोर्ट करें
6. सबसे ऊपर दाएं कोने में मौजूद एनवायरमेंट को चुनें

3. डेवलपर के तौर पर रजिस्टर करना

डेवलपर के तौर पर रजिस्टर करके, अपने Merchant Center खाते को Google Cloud प्रोजेक्ट से लिंक करें. एपीआई डेवलपर की भूमिका वाले उपयोगकर्ताओं को एपीआई से जुड़ी सूचनाएं मिलेंगी. इनमें सेवा से जुड़े ज़रूरी एलान, डेवलपर सर्वे, और मौके शामिल हैं.

1. Postman > Collections > Merchant API Official खोलें
2. accounts_v1 > accounts > accounts.developerRegistration > registerGcp खोलें
3. पाथ में मौजूद {account} प्लेसहोल्डर को अपने MC आईडी से बदलें
4. मुख्य हिस्से में मौजूद {email} प्लेसहोल्डर को अपने ईमेल पते से बदलें
5. रजिस्ट्रेशन पूरा करने के लिए, भेजें पर क्लिक करें
6. अगर सब कुछ सही तरीके से किया गया है, तो आपको इस तरह का पुष्टि करने वाला JSON रिस्पॉन्स मिलेगा: json { "name": "accounts/{YOUR_MC_ID}/developerRegistration", "gcpIds": [ "{YOUR_GCP_ID}" ] }

4. Postman पर Merchant API को टेस्ट करना

1. Postman खोलें > Collections > Merchant API Official > accounts_v1 > accounts > list
2. भेजें पर क्लिक करें
3. अगर सब कुछ सही तरीके से किया गया है, तो आपको इस तरह का पुष्टि करने वाला JSON रिस्पॉन्स मिलेगा: json { "accounts": [ { "name": "accounts/{YOUR_MC_ID}", "accountId": "{YOUR_MC_ID}", "accountName": "{YOUR_MERCHANT_NAME}", "adultContent": false, "timeZone": { "id": "{YOUR_TIMEZONE}" }, "languageCode": "en-US" } ] }