سی آر ایل کے ساتھ HTTP ہیڈر کیسے بھیجیں: مثالوں کے ساتھ ایک جامع گائیڈ

APIs یا ویب سروسز کے ساتھ کام کرنے والے ہر فرد کے لیے cURL کے ساتھ HTTP ہیڈر بھیجنا ایک بنیادی مہارت ہے۔ HTTP ہیڈرز آپ کی درخواست کے بارے میں ضروری معلومات فراہم کرتے ہیں، جیسے مواد کی قسم، اجازت، اور مزید۔ cURL، HTTP درخواستیں کرنے کے لیے ایک طاقتور کمانڈ لائن ٹول، آپ کو ان ہیڈرز کو آسانی سے اپنی مرضی کے مطابق بنانے اور بھیجنے کی اجازت دیتا ہے۔ اس گائیڈ میں، ہم آپ کو سی آر ایل کا استعمال کرتے ہوئے HTTP ہیڈر بھیجنے کے عمل کے بارے میں بتائیں گے، مختلف عملی مثالوں کے ساتھ مکمل۔

شرطیں

اس سے پہلے کہ ہم مثالیں دیکھیں، یقینی بنائیں کہ آپ نے اپنے سسٹم پر cURL انسٹال کر رکھا ہے۔ آپ چیک کر سکتے ہیں کہ آیا یہ چلا کر انسٹال ہے:

curl --version

اگر یہ انسٹال نہیں ہے، تو آپ اسے سرکاری cURL ویب سائٹ سے ڈاؤن لوڈ کر سکتے ہیں۔

بنیادی cURL نحو

cURL کے ساتھ HTTP درخواست بھیجنے کا بنیادی نحو یہ ہے:

curl [options] [URL]

اپنی درخواست میں HTTP ہیڈر شامل کرنے کے لیے، آپ ہیڈر کی معلومات کے بعد -H یا -header آپشن استعمال کر سکتے ہیں۔

مثال 1: اپنی مرضی کے ہیڈرز کے ساتھ GET کی درخواست بھیجنا

آئیے ایک فرضی API کو ایک سادہ GET درخواست کے ساتھ شروع کریں، بشمول ایک حسب ضرورت ہیڈر۔ فرض کریں کہ آپ اپنی API کلید کے ساتھ "Authorization" ہیڈر شامل کرنا چاہتے ہیں۔

curl -H "Authorization: Bearer YOUR_API_KEY" https://api.example.com/resource

YOUR_API_KEY کو اپنی اصل API کلید سے تبدیل کریں۔

مثال 2: JSON ڈیٹا کے ساتھ POST کی درخواست بھیجنا

اس مثال میں، ہم JSON پے لوڈ اور حسب ضرورت مواد کی قسم کے ہیڈر کے ساتھ POST کی درخواست بھیجیں گے۔

curl -X POST -H "Content-Type: application/json" -d '{"name": "John", "email": "[email protected]"}' https://api.example.com/users

یہ کمانڈ درخواست کے طریقہ کار کو POST (-X POST) کے بطور متعین کرتی ہے، مواد کی قسم کو JSON (-H "Content-Type: application/json") پر سیٹ کرتی ہے، اور JSON ڈیٹا کو -d کے ساتھ شامل کرتی ہے۔

مثال 3: ایک سے زیادہ ہیڈر سیٹ کرنا

آپ ایک سی آر ایل کی درخواست میں متعدد ہیڈر شامل کر سکتے ہیں۔ یہاں، ہم "اجازت" اور "صارف-ایجنٹ" دونوں ہیڈر کے ساتھ ایک درخواست بھیج رہے ہیں۔

curl -H "Authorization: Bearer YOUR_API_KEY" -H "User-Agent: MyClient/1.0" https://api.example.com/resource

مثال 4: کوکیز بھیجنا

اپنی درخواست کے ساتھ کوکیز بھیجنے کے لیے، کوکی ڈیٹا کے بعد -b یا -cookie آپشن استعمال کریں۔

curl -b "session=12345; preferences=darkmode" https://api.example.com/dashboard

یہ مثال دو کوکیز بھیجتی ہے: "سیشن" اور "ترجیحات۔"

مثال 5: مندرجہ ذیل ری ڈائریکٹ

پہلے سے طے شدہ طور پر، cURL HTTP ری ڈائریکٹس کی پیروی نہیں کرتا ہے۔ مندرجہ ذیل ری ڈائریکٹ کو فعال کرنے کے لیے، -L یا -location آپشن استعمال کریں۔

curl -L https://example.com

یہ کمانڈ کسی بھی ری ڈائریکٹ کی پیروی کرے گی اور صفحہ کے حتمی مواد کو ظاہر کرے گی۔

مثال 6: کسٹم یوزر ایجنٹ بھیجنا

آپ اپنی درخواست کی شناخت کے لیے ایک حسب ضرورت یوزر ایجنٹ ہیڈر سیٹ کر سکتے ہیں۔

curl -H "User-Agent: MyCustomApp/1.0" https://api.example.com/resource

کسٹم یوزر-ایجنٹ ہیڈر مفید ہوتے ہیں جب APIs کے ساتھ تعامل کرتے ہیں جن کے لیے مخصوص صارف ایجنٹ کی ضرورت ہوتی ہے۔

مثال 7: ڈیٹا کے بغیر درخواست ہیڈر بھیجنا

اگر آپ کو درخواست کے باڈی کے بغیر ہیڈر بھیجنے کی ضرورت ہے، تو آپ -I یا -head آپشن استعمال کر سکتے ہیں۔

curl -I https://api.example.com/resource

یہ کمانڈ HEAD کی درخواست بھیجتی ہے، جو صرف ہیڈرز کو حاصل کرتی ہے نہ کہ اصل مواد۔

مثال 8: بنیادی تصدیق بھیجنا

HTTP بنیادی تصدیقی اسناد بھیجنے کے لیے، آپ Base64 میں انکوڈ کردہ اپنے صارف نام اور پاس ورڈ کے ساتھ "Authorization" ہیڈر شامل کر سکتے ہیں۔

curl -H "Authorization: Basic BASE64_ENCODED_CREDENTIALS" https://api.example.com/resource

BASE64_ENCODED_CREDENTIALS کو اپنے Base64-انکوڈ شدہ صارف نام اور پاس ورڈ (جیسے صارف کا نام: پاس ورڈ) سے تبدیل کریں۔

مثال 9: ڈیبگنگ اور وربوز موڈ

مسائل کا ازالہ کرتے وقت یا HTTP درخواست اور جواب کا معائنہ کرتے وقت، آپ -v یا -verbose آپشن کے ساتھ cURL کا وربوز موڈ استعمال کر سکتے ہیں۔

curl -v https://api.example.com/resource

یہ درخواست اور جواب کے بارے میں تفصیلی معلومات دکھائے گا، بشمول ہیڈر۔

ویب سروسز اور APIs کے ساتھ کام کرنے کے لیے cURL کے ساتھ HTTP ہیڈر بھیجنا ایک اہم مہارت ہے۔ اس گائیڈ میں فراہم کردہ مثالوں کے ساتھ، آپ اپنی درخواستوں کو اپنی مرضی کے مطابق بنا سکتے ہیں، تصدیق کو سنبھال سکتے ہیں، کوکیز بھیج سکتے ہیں، اور بہت کچھ۔ جیسا کہ آپ cURL کی صلاحیتوں سے واقف ہوتے جائیں گے، آپ مختلف ویب سروسز کے ساتھ مؤثر طریقے سے بات چیت کرنے کے لیے اچھی طرح لیس ہو جائیں گے۔