curl कमांड को सीधे PowerShell में पेस्ट करना शायद ही कभी चलता है, और सिर्फ़ इसलिए नहीं कि फ़्लैग अलग हैं। PowerShell डबल-कोट वाली स्ट्रिंग के अंदर वेरिएबल की वैल्यू भर देता है, इसलिए डॉलर चिह्न वाला टोकन चुपचाप खाली स्ट्रिंग बन जाता है और अनुरोध बिना किसी सुराग के 401 लौटाता है। यह कन्वर्टर हर जगह सिंगल-कोट लिटरल लिखता है, जिन्हें PowerShell कच्चे टेक्स्ट की तरह लेता है, और अंदर के हर कोट को दोहरा देता है। हेडर hashtable बनते हैं, JSON बॉडी एक hashtable बनती है जो ConvertTo-Json से होकर जाती है ताकि भेजने से पहले आप उसे बदल सकें, और basic auth को Base64 Authorization हेडर के रूप में दोबारा बनाया जाता है — PowerShell में यही तरीका चलता है। नतीजा Windows PowerShell पर भी और हर प्लैटफ़ॉर्म के PowerShell 7 पर भी जस का तस चलता है।
विशेषताएँ
Invoke-RestMethod, पैरामीटर पढ़ने लायक अलग-अलग पंक्तियों में
हेडर PowerShell hashtable के रूप में
JSON बॉडी hashtable के रूप में, ConvertTo-Json में पाइप की हुई
सिंगल-कोट लिटरल, ताकि टोकन का $ कभी वेरिएबल न बने
basic auth, Base64 Authorization हेडर के रूप में दोबारा बना
Content-Type, -ContentType पैरामीटर के ज़रिए
जिन curl फ़्लैग का PowerShell में कोई जोड़ नहीं, उनकी चेतावनी
नतीजा .ps1 फ़ाइल के रूप में डाउनलोड करें
कन्वर्ज़न पूरी तरह आपके ब्राउज़र में चलता है
cURL से PowerShell का उपयोग कैसे करें
API दस्तावेज़ से curl कमांड कॉपी करें
उसे बाएँ पैनल में पेस्ट करें
दाईं ओर बनी PowerShell स्क्रिप्ट पढ़ें
उसे कॉपी करें, या .ps1 फ़ाइल के रूप में डाउनलोड करें
API की में चाहे जो अक्षर हों, सिंगल कोट वैल्यू को जस का तस रखते हैं।
सामान्य त्रुटियाँ और समस्या निवारण
टोकन सही होने पर भी अनुरोध 401 लौटाता है। — PowerShell की डबल-कोट वाली स्ट्रिंग डॉलर चिह्न के बाद की हर चीज़ को वेरिएबल मानकर भर देती है, इसलिए टोकन का एक हिस्सा गायब हो जाता है। इस कन्वर्टर के लिखे सिंगल कोट बनाए रखें, या डॉलर को बैकटिक से एस्केप करें।
JSON बॉडी सर्वर तक बिगड़कर या गलत टाइप के साथ पहुँचती है। — ConvertTo-Json का -Depth देखें। उसका डिफ़ॉल्ट 2 है, जो नेस्टेड ऑब्जेक्ट को चुपचाप टाइप के नामों में समेट देता है — बना हुआ कोड ठीक इसी वजह से इसे 10 पर रखता है।
बॉडी में non-ASCII अक्षर बिगड़कर पहुँचते हैं। — Windows PowerShell 5.1 बॉडी के लिए डिफ़ॉल्ट रूप से non-UTF-8 एन्कोडिंग इस्तेमाल करता है। या तो PowerShell 7 पर जाएँ, या JSON को UTF-8 बाइट में बदलकर वही बॉडी के रूप में भेजें।
अक्सर पूछे जाने वाले प्रश्न
क्या PowerShell में curl और Invoke-WebRequest एक ही हैं?
Windows PowerShell 5.1 में curl, Invoke-WebRequest का उपनाम (alias) है, इसीलिए असली curl कमांड पेस्ट करने पर उलझाने वाली पैरामीटर त्रुटियाँ आती हैं। PowerShell 7 ने यह उपनाम हटा दिया, इसलिए वहाँ curl इंस्टॉल हो तो असली curl ही चलता है।
Invoke-RestMethod इस्तेमाल करें या Invoke-WebRequest?
API के लिए Invoke-RestMethod — यह JSON जवाब को ऐसे ऑब्जेक्ट में बदल देता है जिनके साथ सीधे काम किया जा सके। Invoke-WebRequest स्टेटस कोड और हेडर के साथ कच्चा जवाब लौटाता है, जो तब चाहिए जब ये ब्योरे मायने रखते हों।
PowerShell में basic authentication कैसे भेजें?
username:password को Base64 में एन्कोड करें और Authorization हेडर के रूप में भेजें। -Credential पैरामीटर मौजूद है, पर वह क्रेडेंशियल तभी भेजता है जब सर्वर चुनौती दे, और कई API ऐसा कभी करते ही नहीं।
पैरामीटर बैकटिक से अलग-अलग पंक्तियों में क्यों बँटे हैं?
बैकटिक PowerShell में पंक्ति को आगे जारी रखने वाला अक्षर है, इसलिए लंबी कॉल कई पंक्तियों में भी पढ़ने लायक रहती है। उसे पंक्ति का आख़िरी अक्षर होना चाहिए, पीछे कोई स्पेस नहीं — हाथ से बदलते समय यह आसानी से टूट जाता है।
क्या बनी हुई PowerShell स्क्रिप्ट Linux और macOS पर चलेगी?
हाँ, PowerShell 7 पर, जो क्रॉस-प्लैटफ़ॉर्म है। cmdlet, hashtable सिंटैक्स और ConvertTo-Json वहाँ भी Windows की तरह ही काम करते हैं।
संबंधित टूल
cURL से Ruby — curl कमांड को net/http वाले Ruby कोड में बदलें।