ہاتھ کے اوزار: Postman اور curl

تین طریقے

1. 1

   curl ایک اوزار ہے جو کمانڈ لائن سے HTTP درخواست بھیج کر جواب دکھاتا ہے۔ آسان ترین کال: curl https://api.fbr.gov.pk/health۔ اگر FBR کا کوئی عوامی health endpoint ہو، تو جواب میں ایک JSON ملے گا { "status": "ok" }۔ مزید flags سے درخواست بڑھائیں۔ -X POST سے فعل بدلیں۔ -H سے header شامل کریں، جیسے -H 'Authorization: Bearer YOUR_KEY'۔ -d سے body شامل کریں، جیسے -d '{"ntn": "1234567"}'۔ سب ملا کر: curl -X POST -H 'Authorization: Bearer abc123' -H 'Content-Type: application/json' -d '{"ntn":"1234567"}' https://api.fbr.gov.pk/taxpayers/verify۔ یہی ایک سطر ہے جو ایک کارپوریٹ اکاؤنٹنٹ کے ٹیکس فائلنگ سافٹ ویئر میں ہر منٹ چل رہی ہے۔

2. 2

   Postman وہی تصور ایک دوستانہ انٹرفیس میں لپیٹتا ہے۔ آپ ڈراپ ڈاؤن سے فعل چنتے ہیں، URL لکھتے ہیں، Headers ٹیب پر Authorization ڈالتے ہیں، Body ٹیب میں JSON رکھتے ہیں، Send دباتے ہیں۔ نیچے کے پین میں جواب آتا ہے، خوبصورت رنگوں کے ساتھ، اسٹیٹس کوڈ اور وقت کونے میں۔ درخواست محفوظ کریں، اسے collection میں رکھیں، collection کسی ساتھی کے ساتھ شیئر کریں۔ curl تیز اور اسکرپٹ ہو سکتا ہے، Postman دستاویزی ہے۔ ایک منظم Postman collection کسی ادارے کی پیش کی جانے والی سب سے ایماندار API دستاویز ہے۔

3. 3

   FBR کے ای انوائسنگ سینڈ باکس کے ساتھ ایک عملی مثال۔ FBR کا REA-Q منصوبہ، یعنی ڈیجیٹل انوائسنگ کی اصلاح، ایک ٹیسٹ endpoint دیتا ہے: https://gw.fbr.gov.pk/test/v1/di_data/Upload_Sales_Invoice۔ درخواست JSON میں انوائس کا ہیڈر، لائن آئٹمز، خریدار کا NTN، فروخت کنندہ کا NTN چاہتی ہے۔ جواب میں IRN یعنی انوائس کا حوالہ نمبر اور QR کوڈ کا data ملتا ہے۔ Postman میں ایک collection بنائیں 'FBR Sandbox' نام سے، ایک environment میں ٹیسٹ API key رکھیں، تین درخواستیں (login، invoice upload، IRN fetch) شامل کریں، اور ایک چھوٹا ٹیسٹ اسکرپٹ لگائیں جو 200 status کی تصدیق کرے۔ curl میں یہی کام تین سطروں کا shell اسکرپٹ ہے۔ دونوں صورتوں میں آپ کے پاس پروڈکشن کوڈ کی پہلی لائن لکھنے سے پہلے سینڈ باکس کا automated ٹیسٹ سوٹ موجود ہے۔

کیوں؟

Claude کے ساتھ آزمائیں

Claude یا ChatGPT کے ساتھ آزمانے کے لیے پرامپٹ: 'میرے پاس FBR ای انوائسنگ کی پانچ API کالز کا Postman collection ہے۔ ایک curl shell اسکرپٹ لکھیں جو انہیں ترتیب سے چلائے، پہلی کال کا IRN لے کر دوسری میں استعمال کرے۔ خرابی پر اسکرپٹ صاف انگریزی اور اردو میں پیغام دے کر بند ہو۔' پھر آؤٹ پُٹ چلائیں۔ ہر اس جگہ کا نوٹ لیں جہاں AI نے من گھڑت بات کی۔