API اصل میں کیا ہے

What an API actually is

35 منٹ

افتتاحیہ

جب آپ مال روڈ پر HBL کے ATM پر اپنا ڈیبٹ کارڈ ڈالتے ہیں، تو اس مشین کو آپ کا بیلنس معلوم نہیں ہوتا۔ وہ HBL کے کور بینکنگ سسٹم کو درخواست بھیجتی ہے، جو 1LINK کو بھیجتی ہے، جو پھر اس بینک تک پہنچاتی ہے جس نے آپ کا کارڈ جاری کیا تھا۔ ہر نظام ایک طے شدہ زبان بولتا ہے۔ ہر درخواست کی ایک طے شدہ شکل ہوتی ہے۔ کوئی فون نہیں کرتا۔ مشینیں صرف معاہدے پر بھروسہ کرتی ہیں۔ یہی معاہدہ API ہے۔ آگے پڑھنے سے پہلے سوچیں: روزمرہ زندگی میں اور کہاں دو مشینیں خاموشی سے ایک طے شدہ پیغام کا تبادلہ کر رہی ہیں؟

تین طریقے

API کا مطلب ہے Application Programming Interface، مگر یہ لفظ بات کو سمجھانے کے بجائے چھپا دیتے ہیں۔ API کو ایک ریستوران کے مینو کی طرح سمجھیں۔ باورچی خانہ سینکڑوں چیزیں بنا سکتا ہے، مگر مینو پر صرف وہی چیزیں لکھی ہیں جو آپ منگوا سکتے ہیں، کیسے منگوا سکتے ہیں، اور بدلے میں کیا ملے گا۔ آپ باورچی خانے میں گھس کر شیف کو حکم نہیں دیتے۔ آپ مینو پر ایک سطر کی طرف اشارہ کرتے ہیں، الفاظ بالکل ٹھیک بولتے ہیں، اور پلیٹ آپ کے سامنے آ جاتی ہے۔ مینو معاہدہ ہے۔ باورچی خانہ نظام ہے۔ ویٹر نیٹ ورک ہے۔ API ایک شائع شدہ مینو ہے، اور یہ وعدہ ہے کہ ہر سطر کا احترام کیا جائے گا۔
ایک ٹھوس پاکستانی مثال لیں۔ NADRA مجاز بینکوں اور موبائل کمپنیوں کو ایک تصدیقی API دیتا ہے۔ جب آپ میزان بینک میں نیا اکاؤنٹ کھولتے ہیں یا جاز کا سم ایکٹیویٹ کراتے ہیں، تو ایجنٹ آپ کا CNIC اور انگوٹھے کا نشان ٹرمینل میں ڈالتا ہے۔ وہ ٹرمینل NADRA کے API کو درخواست بھیجتا ہے: 'یہ CNIC اور بایومیٹرک ہے، شناخت کی تصدیق کریں۔' NADRA ہاں یا نا کا جواب اعتماد کے درجے کے ساتھ دیتا ہے۔ بینک کو NADRA کا اندرونی ڈیٹابیس کبھی نظر نہیں آتا۔ بینک کو صرف وہی نظر آتا ہے جس کا معاہدہ ہوا۔ معاہدہ دونوں کی حفاظت کرتا ہے۔ NADRA کنٹرول کرتا ہے کہ کیا باہر جائے۔ بینک کو وہی ملتا ہے جس کی اسے ضرورت ہے۔
ہر API کے تین اجزا ہیں۔ پہلا، endpoint یعنی وہ پتہ جس پر آپ درخواست بھیجتے ہیں، مثلاً https://api.nadra.gov.pk/verify۔ دوسرا، درخواست کی شکل یعنی endpoint کیا ڈیٹا چاہتا ہے، عام طور پر CNIC، انگوٹھے کا نشان اور آپ کی اجازت کی کلید۔ تیسرا، جواب کی شکل یعنی آپ کو کیا واپس ملتا ہے، اکثر ایک اسٹیٹس، اعتماد کا اسکور، اور ایک آڈٹ ریفرنس۔ ان تینوں میں سے کسی ایک کو بھی بغیر اطلاع کے بدل دیں، اور API استعمال کرنے والا ہر نظام ٹوٹ جاتا ہے۔ اسی لیے API معاہدوں کے ورژن ہوتے ہیں اور API کا ڈیزائن اس کے پیچھے کے کوڈ سے زیادہ اہم ہے۔

فوری چیک

فوری چیک: جدید AI روایتی قاعدہ بنیاد پروگرام سے کس طرح مختلف ہے؟

کیوں؟

کیوں کا پہلا درجہ: API کی ضرورت ہی کیوں ہے؟ کیونکہ کوئی ایک نظام سب کچھ نہیں کر سکتا۔ بینک اپنا شناختی ڈیٹابیس خود نہیں رکھ سکتا۔ سواری بلانے والی ایپ اپنا نقشہ نظام نہیں چلا سکتی۔ سرکاری پورٹل ادائیگی کا پورا نظام دوبارہ نہیں لکھ سکتا۔ API اسی کام آتے ہیں کہ مہارت رکھنے والے نظام ایک دوسرے کی صلاحیتیں ادھار لے سکیں بغیر ایک بڑے کمزور پروگرام میں ضم ہوئے۔

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

Claude یا ChatGPT کے ساتھ آزمانے کے لیے پرامپٹ: 'میں FBR کے پالیسی ونگ میں کام کرتا ہوں۔ پاکستان کے دیگر سرکاری محکمے آج کن پانچ عوامی APIs کی پیش کش کرتے ہیں؟ ہر API کیا واپس کرتا ہے؟ FBR ان میں سے ہر ایک کو شہری خدمت میں کیسے استعمال کر سکتا ہے؟ سرکاری URL بھی دیں۔' جواب کا موازنہ سبق 7 کے سروے سے کریں۔

ماخذ

ماخذ اور مزید مطالعہ۔ MDN Web Docs، 'Introduction to web APIs'۔ IBM، 'What is an API'۔ Postman Learning Center، 'What is an API'۔ NADRA Verisys کا تعارف (nadra.gov.pk)۔ اسٹیٹ بینک پاکستان کا اوپن بینکنگ فریم ورک مسودہ (sbp.org.pk)۔