API दस्तावेज़ curl में लिखे जाते हैं और ऐप्लिकेशन Ruby में, इसलिए वही अनुवाद बार-बार हाथ से करना पड़ता है। यह कन्वर्टर काम के फ़्लैग पढ़ता है — मेथड, हेडर, डेटा, basic auth और -G के पीछे की क्वेरी व्यवस्था — और net/http पर बनी स्क्रिप्ट लिखता है, जो Ruby के साथ ही आता है और किसी gem को इंस्टॉल करने की ज़रूरत नहीं रखता। JSON बॉडी को किसी अपारदर्शी स्ट्रिंग की तरह चिपकाने के बजाय hash के रूप में लिखा जाता है और वह JSON.generate से होकर जाती है, ताकि चलाने से पहले उसे बदलना आसान रहे, और -u फ़्लैग हाथ से बने Authorization हेडर के बजाय basic_auth कॉल बन जाता है। नतीजा ऐसा कोड है जिसे कोई भी Ruby डेवलपर अपना ही लिखा हुआ समझे।
विशेषताएँ
स्टैंडर्ड लाइब्रेरी का net/http, इसलिए कुछ भी इंस्टॉल नहीं करना
हेडर, अनुरोध बॉडी, क्वेरी स्ट्रिंग और basic auth — सब साथ आते हैं
JSON बॉडी बदलने लायक Ruby hash के रूप में
हाथ से बने Authorization हेडर की जगह basic_auth
गैर-मानक HTTP मेथड Net::HTTPGenericRequest से
https URL के लिए TLS अपने-आप चालू
जिन curl फ़्लैग का Ruby में कोई जोड़ नहीं, उनकी चेतावनी
नतीजा .rb फ़ाइल के रूप में डाउनलोड करें
कन्वर्ज़न पूरी तरह आपके ब्राउज़र में होता है
cURL से Ruby का उपयोग कैसे करें
API दस्तावेज़ से curl कमांड कॉपी करें
उसे बाएँ पैनल में पेस्ट करें
दाईं ओर बना Ruby कोड पढ़ें
उसे कॉपी करें, या .rb फ़ाइल के रूप में डाउनलोड करें
उदाहरण
इनपुट
curl -X POST https://api.example.com/users -H "Content-Type: application/json" -d '{"name":"Ada"}'
बॉडी बदलने लायक hash के रूप में आती है, कोट में बंद गठरी के रूप में नहीं।
सामान्य त्रुटियाँ और समस्या निवारण
स्क्रिप्ट SSL सत्यापन की त्रुटि देती है। — आम तौर पर इसका मतलब सेल्फ़-साइन्ड या अंदरूनी सर्टिफ़िकेट होता है। सत्यापन बंद करने के बजाय OpenSSL को अपने CA बंडल की ओर इशारा करें — curl के -k फ़्लैग का कोई सुरक्षित जोड़ नहीं है और उसे जानबूझकर अनुवादित नहीं किया जाता।
API अनुरोध की बॉडी को अस्वीकार कर देता है। — देखें कि कॉपी में Content-Type हेडर बचा रहा या नहीं। net/http उसे आपके लिए सेट नहीं करता, इसलिए बिना हेडर भेजे गए JSON पेलोड को सर्वर अक्सर फ़ॉर्म डेटा समझ लेता है।
रीडायरेक्ट का पालन नहीं होता। — curl के -L का कोई सीधा जोड़ नहीं है — net/http 3xx जवाब लौटा देता है और फ़ैसला आप पर छोड़ता है। Net::HTTPRedirection की जाँच करें और ज़रूरत हो तो Location हेडर वाले पते पर दोबारा अनुरोध भेजें।
अक्सर पूछे जाने वाले प्रश्न
क्या बने हुए Ruby कोड को किसी gem की ज़रूरत है?
नहीं। यह net/http, uri और json इस्तेमाल करता है, जो सब Ruby के साथ आते हैं, इसलिए स्क्रिप्ट सामान्य इंस्टॉलेशन पर बिना कुछ इंस्टॉल किए चलती है।
Faraday या HTTParty के बजाय net/http क्यों?
स्टैंडर्ड लाइब्रेरी का कोड बिना Gemfile के कहीं भी चलता है, इसलिए किसी अनजान प्रोजेक्ट में चिपकाए जाने वाले स्निपेट के लिए यही सबसे सुरक्षित डिफ़ॉल्ट है। बाद में इसे किसी gem पर ले जाना आसान है — हेडर और बॉडी पहले से अलग किए हुए हैं।
Ruby कोड में basic auth कैसे संभाला जाता है?
-u फ़्लैग request.basic_auth कॉल बन जाता है, जिसमें यूज़रनेम और पासवर्ड अलग-अलग आर्ग्युमेंट होते हैं। यही स्वाभाविक Ruby तरीका है, और इससे वह Base64 एन्कोडिंग का चरण बचता है जो हाथ से बने Authorization हेडर के लिए चाहिए।
असामान्य HTTP मेथड के साथ Ruby कोड में क्या होता है?
जिन मेथड की अपनी Net::HTTP क्लास नहीं है, जैसे PURGE, उन्हें Net::HTTPGenericRequest से लिखा जाता है और मेथड का नाम स्ट्रिंग के रूप में जाता है — इससे वह हर मेथड संभल जाता है जिसे सर्वर स्वीकार करता हो।
क्या Ruby में बदलते समय मेरा curl कमांड मशीन से बाहर जाता है?
नहीं। पार्सिंग और कोड बनाना आपके ब्राउज़र में होता है, इसलिए लाइव API टोकन वाला कमांड कभी आपकी मशीन से बाहर नहीं जाता।