मुख्य अवधारणाएँ
जैसे ही ये चार डिज़ाइन समझ आ जाएँ, आगे का हर प्रोटोकॉल और परिदृश्य आसान हो जाता है:
- तीन सत्ता मॉडल: ग्रुप / एनवायरनमेंट / रिक्वेस्ट कैसे जुड़े हैं
- एनवायरनमेंट Pre-URL डिज़ाइन: रिक्वेस्ट केवल रिलेटिव पाथ क्यों रखते हैं
- भेजने की असेंबली पाइपलाइन: एक Send कॉन्फ़िगरेशन को असली रिक्वेस्ट में कैसे बदलता है
- वेरिएबल सिस्टम:
{{variable}}कहाँ से रिज़ॉल्व होता है, और तीन वेरिएबल लेयर
तीन सत्ता मॉडल
एनवायरनमेंट हर रिक्वेस्ट की बजाय ग्रुप से क्यों बंधा है? ग्रुप आमतौर पर "एक डिप्लॉयमेंट टारगेट के तहत एक मॉड्यूल के सभी API" को दर्शाता है। ग्रुप लेवल पर बाइंडिंग का मतलब है क ि एनवायरनमेंट बदलने पर पूरी ग्रुप एक साथ बदल जाती है — हर रिक्वेस्ट अलग-अलग एडिट करने की ज़रूरत नहीं। अगर किसी एक रिक्वेस्ट को अलग एनवायरनमेंट चाहिए, तो उसे उस एनवायरनमेंट से बंधी ग्रुप में डाल दें।
एनवायरनमेंट Pre-URL डिज़ाइन
यह सबसे महत्वपूर्ण — और सबसे ज़्यादा ग़लत समझा जाने वाला — डिज़ाइन है।
रिक्वेस्ट रिलेटिव पाथ रखते हैं; एनवायरनमेंट बेस एड्रेस रखते हैं
पारंपरिक टूल्स में हर रिक्वेस्ट पूरा URL रखता है (https://api.example.com/v1/users), इसलिए टेस्ट एनवायरनमेंट पर जाने का मतलब डोमेन की बैच-रिप्लेसमेंट है। यह टूल इसे उलट देता है:
स्कीम प्रोटोकॉल और TLS तय करती है (मुख्य!)
Pre-URL प्रति प्रोटोकॉल संग्रहीत होते हैं, लेकिन कोई एंट्री वास्तव में कौन-सा प्रोटोकॉल सर्व करती है, यह URL की शुरुआत की स्कीम तय करती है। स्कीम एक साथ "कौन-सा प्रोटोकॉल" और "एन्क्रिप्टेड या नहीं (TLS)" व्यक्त करती है:
| प्रोटोकॉल | साधारण स्कीम | एन्क्रिप्टेड स्कीम |
|---|---|---|
| HTTP | http:// | https:// |
| WebSocket | ws:// | wss:// |
| TCP | tcp:// | tcps:// |
| UDP | udp:// | — |
| gRPC | grpc:// | grpcs:// |
| MQTT | mqtt:// | mqtts:// |
⚠️ आम गलती: WebSocket का बेस एड्रेस
ws:///wss://के रूप में लिखना होगा। अगरhttps://टाइप किया, तो उसे HTTP माना जाएगा और WebSocket रिक्वेस्ट बेस एड्रेस के बिना फ़ेल हो जाएगा। प्रोटोकॉल लाइन और स्कीम को सुसंगत रखें।
भेजने की असेंबली पाइपलाइन
"Send" दबाना सीधे सॉकेट नहीं छोड़ता। पाइपलाइन "रिक्वेस्ट + ग्रुप का एनवायरनमेंट + वेरिएबल" को क़दम-दर-क़दम असली रिक्वेस्ट में जोड़ती है और नेटवर्क कॉल के पहले-बाद एक्शन चेन डालती है:
मुख्य बातें:
- एक्शन चेन केवल "execute scripts" चालू होने पर चलते हैं। ऐप में Send दबाने पर वे डिफ़ॉल्ट रूप से चलते हैं; ऑटोमेटेड / MCP सेंड को स्पष्ट रूप से ऑप्ट-इन करना होगा। स्क्रिप्ट बंद होने पर, प्री-सेंड में इंजेक्ट किए गए टोकन या एन्क्रिप्शन सीधे नहीं होते — इसी वजह से recipes का "टोकन नहीं → 401" नेगेटिव कंट्रोल ऐसा व्यवहार करता है।
- प्री-सेंड स्क्रिप्ट जाने वाली रिक्वेस्ट को रीराइट करते हैं; पोस्ट-रिस्पॉन्स स्क्रिप्ट मिली हुई रिस्पॉन्स को रीराइट करते हैं। दोनों रनटाइम वेरिएबल पढ़ और लिख सकते हैं।
वेरिएबल सिस्टम
तीन तरह के "वेरिएबल" हैं, अलग-अलग स्कोप के साथ। उन्हें मिलाना शुरुआती लोगों की सबसे आम गलती है।
{{name}} वास्तव में क्या रिज़ॉल्व कर सकता है?
| कहाँ लिखा है | एनवायरनमेंट वेरिएबल | रनटाइम वेरिएबल | आम उपयोग |
|---|---|---|---|
{{name}} (URL / params / headers / body में) | ✅ | ❌ | एनवायरनमेंट कॉन्फ़िग का उल्लेख, डायनामिक भराई |
| स्क्रिप्ट के अंदर वेरिएबल पढ़ना | ✅ | ✅ | रिक्वेस्ट के बीच लॉगिन टोकन पास करना आदि |
स्मरण-सूत्र:
{{}}केवल "कॉन्फ़िगरेशन-प्रकार" के वेरिएबल देखता है; स्क्रिप्ट तीनों ल ेयर पढ़ सकते हैं। रनटाइम वेरिएबल "रनटाइम ब्लैकबोर्ड" हैं — उस पर सिर्फ़ स्क्रिप्ट लिख सकते हैं, और{{}}कभी वहाँ नहीं देखता।
{{authToken}} लॉगिन पर सेव किया टोकन क्यों नहीं पढ़ता? क्योंकि लॉगिन स्क्रिप्ट ने उसे रनटाइम लेयर में रखा, जिसे {{}} पार्स नहीं करता। सही तरीका एक प्री-सेंड स्क्रिप्ट है जो उसे पढ़कर हेडर इंजेक्ट करे (देखें recipes, परिदृश्य 1)।
डायनामिक वेरिएबल {{$xxx}}
{{}} के अंदर बिल्ट-इन डायनामिक वेरिएबल का एक सेट भी है, जो हर मूल्यांकन पर ताज़ा बनता है और URL / params / headers / body में सीधे उपयोग होता है:
| वेरिएबल | बनाता है |
|---|---|
{{$timestamp}} / {{$timestampMs}} | सेकंड / मिलीस ेकंड में Unix टाइमस्टैम्प |
{{$isoTimestamp}} | ISO8601 UTC |
{{$uuid}} / {{$guid}} | UUID v4 |
{{$randomInt}} / {{$randomInt min,max}} | रैंडम पूर्णांक (डिफ़ॉल्ट 0..1000) |
{{$randomBoolean}} {{$randomFullName}} {{$randomEmail}} {{$randomPhoneNumber}} {{$randomIpv4}} {{$randomIpv6}} {{$randomUrl}} {{$randomColor}} {{$randomHexadecimal}} {{$randomAlphaNumeric}} {{$randomCity}} {{$randomCountry}} {{$randomDateRecent}} {{$randomPrice}} {{$randomWord}} {{$randomLorem}} {{$randomCompanyName}} आदि | मिश्रित रैंडम सैंपल डेटा |
उदाहरण: GET /echo?ts={{$timestamp}}&u={{$uuid}} — व्यावहारिक रूप से हर सेंड ts/u को ताज़ा असली मानों से बदल देती है।
सारांश
- रिक्वेस्ट पाथ फ़्रैगमेंट रखते हैं; एनवायरनमेंट Pre-URL के ज़रिए प्रति प्रोटोकॉल बेस एड्रेस देते हैं; स्कीम प्रोटोकॉल + TLS तय करती है।