دوسرے سافٹ ویئر کو آپ کا ڈیٹا پڑھنے دینا

API اسٹوڈیو: ایک وقت میں ایک اسکرین شائع کرنا، ایک کلید جاری کرنا، اسے ایڈریس پر پن کرنا، اور AI ایجنٹ کے لیے MCP سرور جیسی اشاعت۔

جلد یا بدیر TRANXACT سے باہر کی کوئی چیز آپ کا ڈیٹا چاہتی ہے: ایک رپورٹنگ ٹول، ایک پارٹنر کا سسٹم، ایک ویب سائٹ جس کو قیمت کی فہرست کی ضرورت ہے، ایک AI ایجنٹ جس سے آپ کے کاروبار کے بارے میں سوال پوچھا گیا ہو۔ API اسٹوڈیو، پلیٹ فارم کے تحت، وہ جگہ ہے جہاں آپ فیصلہ کرتے ہیں کہ اسے کیا ہونے کی اجازت ہے — ایک وقت میں ایک اسکرین، ایک وقت میں ایک کالم۔

باہر سے کوئی چیز اس وقت تک نہیں پہنچتی جب تک کہ کوئی اسے شائع نہ کرے۔ ایسی کوئی ترتیب نہیں ہے جو ہر چیز کو کھول دے اور کوئی کلید نہیں جو ہر چیز تک پہنچ جائے۔ بالکل نئی تعیناتی میں کوئی API سطح نہیں ہے، اور یہ کسی چیز کے آن ہونے کے انتظار میں ہونے کی بجائے صحیح ابتدائی پوزیشن ہے۔

چار فیصلے، ترتیب میں

اسکرین شائع کرنا

1. پلیٹ فارم → API اسٹوڈیو کھولیں اور ایک اسکرین منتخب کریں۔ فہرست ہر وہ اسکرین ہے جو کنسول کے پاس ہے، خود پروڈکٹ کو پڑھیں - لہذا اس ریلیز کو بھیجنے والی اسکرین اس پر ہے۔
2. ان کالموں پر نشان لگائیں جو چھوڑ سکتے ہیں۔ کوئی بھی چیز جس پر ٹک نہیں کیا گیا ہے وہ کبھی بھیجا نہیں جاتا ہے: فہرست میں نہیں، کسی ایک ریکارڈ میں نہیں، اس میں نہیں کہ کیا لکھا جائے گا۔ کسی بھی چیز کو جان بوجھ کر شروع کرنے کے لئے ٹک نہیں کیا جاتا ہے۔
3. فعل کا فیصلہ کریں۔ پڑھنا بطور ڈیفالٹ آن ہے؛ بنائیں، تبدیل کریں اور حذف کریں ہر ایک الگ فیصلہ ہے، کیونکہ ان کے سسٹم کو آپ کے آئٹم ماسٹر کو پڑھنے دینا اور ان کے سسٹم کو اسے حذف کرنے دینا ایک ہی سزا نہیں ہے۔
4. اختیاری طور پر قطاروں کو محدود کریں — صرف پوسٹ کردہ رسیدیں، صرف اس سال۔ یہ وہی فلٹر ہے جو ہر لسٹ اسکرین بولتا ہے، ہر کال پر سرور پر لاگو ہوتا ہے، اور کال کرنے والا کوئی بھی چیز اسے وسیع نہیں کر سکتا۔
5. اسے محفوظ کریں۔ یہ ایک مسودہ ہے، اور مسودہ کچھ بھی نہیں پہنچتا۔ جب آپ کا مطلب ہو تو اسے لائیو بنائیں۔
6. کسی کو چابی دینے سے پہلے پیش نظارہ کو دبائیں۔ یہ بالکل ظاہر کرتا ہے کہ ایک پارٹنر کو کیا ملے گا، اور کتنے کالم روکے گئے تھے۔

سافٹ ویئر کی رجسٹریشن

کلائنٹ سافٹ ویئر کے ایک ٹکڑے کا ریکارڈ ہوتا ہے: اسے کیا کہا جاتا ہے، یہ کیا ہے، اس کے بارے میں کس سے رابطہ کرنا ہے، اور — اہم — یہ آپ کا کون سا صارف کام کرتا ہے۔ کلید کی ہر کال اس شخص کے طور پر کی جاتی ہے۔ وہ جو کچھ بھی نہیں کر سکتے، کلید بھی نہیں کر سکتی۔

کلید خود ایک بار دکھائی جاتی ہے، جب اسے جاری کیا جاتا ہے، اور دوبارہ کبھی نہیں۔ نیا جاری کرنے سے پرانا فوراً کام کرنا بند کر دیتا ہے۔ کلائنٹ کو حذف کیے بغیر ایک چابی واپس لی جا سکتی ہے، اس لیے رجسٹر اب بھی یہ بتاتا ہے کہ کس کے پاس پہنچا تھا اور اسے کب چھین لیا گیا تھا۔

جہاں سے ایک چابی استعمال کی جا سکتی ہے۔

اجازت یافتہ پتے کے ساتھ ایک کلید کچھ تک نہیں پہنچتی۔ کسی بھی ایڈریس کا نام نہیں پڑھا جاتا ہے جو ابھی تک قابل رسائی نہیں ہے اور کبھی بھی کہیں سے بھی قابل رسائی نہیں ہے، کیونکہ ایک لیک ہونے والی کلید جو دنیا کے کسی بھی لیپ ٹاپ سے کام کرتی ہے، سارا خطرہ ہے۔ چار قسم کے اندراج: ایک براؤزر کی اصل، ایک حوالہ دینے والا میزبان، واحد پتہ، یا CIDR فارم میں ایک نیٹ ورک۔

جو انضمام کر رہا ہے اسے کیا بھیجنا ہے۔

اسٹوڈیو چار پتے پرنٹ کرتا ہے۔ بنیاد /api/v1 ہے، کلید ایک Authorization: Bearer header میں جاتی ہے، /api/v1/resources فہرست کرتا ہے کہ یہ کلید کس تک پہنچ سکتی ہے، اور /api/v1/openapi.json وہی چیز ہے جو OpenAPI 3.1 دستاویز ہے۔

یہ دونوں اس کلید سے پیدا ہوتے ہیں جو ان سے پوچھتی ہے۔ ایک پارٹنر کو کبھی بھی کوئی دستاویز نہیں دی جاتی ہے جس میں چالیس اختتامی نکات کی فہرست ہوتی ہے جسے وہ کال نہیں کر سکتے ہیں: وہ بالکل وہی بیان کرتا ہے جسے وہ کال کر سکتے ہیں اور کچھ بھی نہیں، اور یہ ایسے راستے کی وضاحت نہیں کر سکتا جس سے انکار کر دیا جائے، کیونکہ یہ انہی قطاروں سے بنایا گیا ہے جو درخواست ہینڈلر چیک کرتا ہے۔

AI ایجنٹ کے لیے وہی ڈیٹا

پتہ /api/v1/mcp ایک ماڈل سیاق و سباق پروٹوکول سرور ہے۔ اس سے جڑنے والے ایجنٹ کو ہر چیز کے لیے ایک ٹول پیش کیا جاتا ہے جو کلید کر سکتی ہے اور کچھ نہیں — ڈیٹا کے لیے کوئی ٹول کسی نے شائع نہیں کیا، کسی فعل کے لیے کوئی ٹول نہیں دیا گیا ہے۔ یہ ایک ہی اشاعت ہے، جو ایک ڈویلپر کے بجائے ماڈل کے لیے بیان کی گئی ہے، لہذا دونوں کبھی بھی قدم سے باہر نہیں نکل سکتے۔

ہر کال پر کیا ہوتا ہے۔

ایک شائع شدہ کال ڈیٹا بیس میں شارٹ کٹ نہیں ہے۔ اس کی توثیق کی جاتی ہے، نمائش اور گرانٹ کے خلاف جانچ پڑتال کی جاتی ہے، اور پھر پلیٹ فارم کے اپنے API کے ذریعے آپ کے بطور صارف کے طور پر بنایا جاتا ہے — وہی راستہ جو کنسول استعمال کرتا ہے۔ کمپنی کی اسکوپنگ، بزنس یونٹ اسکوپنگ، جگہ کی پابندیاں، بند ادوار، پوسٹنگ کے قواعد، حسب ضرورت فیلڈز، حسب ضرورت منطق، قابل تدوین اور آڈٹ ٹریل سبھی لاگو ہوتے ہیں، کیونکہ یہ ایک ہی کوڈ پر چل رہے ہیں۔

ہر کال ریکارڈ کی جاتی ہے، اجازت دی جاتی ہے یا انکار، وجہ کے ساتھ۔ وہ لاگ پلیٹ فارم → API اسٹوڈیو → API کال لاگ کے تحت ہے، اور ایک ایسے ایڈریس سے پیش کی جانے والی کلید جس کی کسی کو اجازت نہیں ہے وہ واحد سب سے دلچسپ لائن ہے جو یہ تیار کرتی ہے۔

جب یہ کام نہیں کرتا