ڈویلپرز کے لیے
Zinn Digital® ایک API-first پلیٹ فارم ہے۔ وہی انجن API جو ہمارے ڈیش بورڈ کو طاقت دیتا ہے، وہی آپ کو ملتا ہے — versioned، spec-first اور بلڈ کے وقت 100% دستاویزی، تیار کردہ SDKs، ایک CLI، ایک Terraform provider، دستخط شدہ webhooks اور اس کے اوپر ایک MCP server کے ساتھ۔ آپ کام کے لیے جو بھی استعمال کریں — ٹرمینل، پائپ لائن، اسٹیٹ فائل یا کوئی AI ایجنٹ — پلیٹ فارم اس کا جواب دیتا ہے۔
زیادہ تر ہوسٹس کنٹرول پینل میں بعد میں API جوڑتے ہیں، اور یہ واضح نظر آتا ہے — پینل کی نصف خصوصیات کبھی باہر نہیں آتیں۔ ہم نے اس کے برعکس کیا۔ ڈیش بورڈ، ایڈمن کنسول، CLI، ٹیرافارم پرووائڈر، MCP سرور اور آپ کے اپنے انٹیگریشنز سب ایک ہی انجن API استعمال کرتے ہیں۔ اگر آپ یہ پینل میں کر سکتے ہیں، تو آپ اسے کوڈ میں بھی کر سکتے ہیں۔
اوپن اے پی آئی اسپیک واحد حقیقت ہے، اور کوئی بھی اینڈ پوائنٹ اس وقت تک ریلیز نہیں ہوتا جب تک وہ اس اسپیک میں شامل نہ ہو۔ یہی ایک اصول پبلک اے پی آئی کو بعد میں نہیں بلکہ بلڈ کے وقت ہی مکمل طور پر ڈاکیومینٹڈ بنا دیتا ہے — اس میں کوئی بھی غیر ڈاکیومینٹڈ حصہ نہیں ہوتا، کیونکہ کوئی غیر ڈاکیومینٹڈ اینڈ پوائنٹ وجود ہی نہیں رکھ سکتا۔
تعاملی حوالہ جات کی دستاویزات، چاروں کلائنٹ SDKs، CLI کا بڑا حصہ اور Terraform فراہم کنندہ کا اسکیفولڈنگ سب اسی ایک تخصیص سے تخلیق کیے جاتے ہیں۔ ایک ماخذ، متعدد نمونے، ہمیشہ ہم آہنگ — آپ کو کبھی بھی ایسی دستاویز کے پیچھے نہیں بھاگنا پڑتا جو عمل آوری سے الگ ہو گئی ہو۔
اینڈ پوائنٹس ایک شائع شدہ فرسودگی کی پالیسی اور تبدیلی کے لاگ کے ساتھ /v1 کے تحت کام کرتے ہیں۔ آپ کو کسی بھی تبدیلی کے بارے میں، بل کے ناکام ہونے سے خود بخود پتہ چلنے کے بجائے، تحریری طور پر پہلے ہی مطلع کر دیا جاتا ہے۔
عمل آوری بمقابلہ تخصیص کا کنٹریکٹ ٹیسٹ اور OpenAPI لنٹنگ ہر تبدیلی پر چلتی ہے۔ کوڈ اور کنٹریکٹ کے درمیان فرق بلڈ کو ناکام بنا دیتا ہے — تاکہ جس تخصیص سے آپ اپنا کلائنٹ جنریٹ کرتے ہیں، سرور واقعی اسی تخصیص کی تعمیل کرے۔
داخل ہونے کے دو راستے ہیں، لیکن ان کے پیچھے ایک ہی یکساں اصول ہے۔ آپ جو بھی استعمال کریں، وہی اجازت کی جانچ پڑتال اور ڈیٹا بیس کی سطح پر ایک جیسا آئسولیشن لاگو ہوتا ہے۔
کلیدیں zdk_<mode>_<prefix>_<secret> کی طرح ہوتی ہیں۔ خفیہ کا صرف ایک SHA-256 ہیش محفوظ کیا جاتا ہے — جاری کرنے کے بعد ہم آپ کو کلید دوبارہ نہیں دکھا سکتے، اور نہ ہی کوئی اور جو ہمارے ڈیٹا بیس تک رسائی حاصل کرے۔ کلیدوں کے اسکوپس ہوتے ہیں، انہیں منسوخ کیا جا سکتا ہے، اور یہ فی شخص کے بجائے فی تنظیم جاری کی جاتی ہیں۔
سینڈ باکس کیز پروڈکشن کیز سے الگ ہوتی ہیں اور سینڈ باکس موڈ پر چلتی ہیں: کوئی حقیقی بلنگ نہیں، کوئی حقیقی پروویژننگ نہیں۔ آپ کے انٹیگریشن ٹیسٹس پیسے خرچ کیے بغیر یا سرور بنائے بغیر API پر بوجھ ڈال سکتے ہیں۔
صارف کے سیشنز Keycloak کے جاری کردہ JWTs کے ذریعے تصدیق شدہ ہوتے ہیں، جن کی تصدیق رلم پبلک کی کے خلاف کی جاتی ہے، اور یہ اسی پرنسپل ابجیکٹ میں ریزولو ہوتے ہیں جو ایک API کی کرتی ہے۔ اینڈ پوائنٹس دانے دار اجازت کی کیز جیسے کہ sites.create یا apikeys.manage پر گیٹ کرتے ہیں، جن کی جانچ فی تنظیم کی جاتی ہے — ایک تنظیم میں دی گئی اجازت کسی دوسری، غیر متعلقہ تنظیم تک رسائی نہیں دیتی، حالانکہ یہ اس کے تحت نیسٹ شدہ تنظیموں پر لاگو ہوتی ہے۔
ہر ٹیننٹ کی درخواست ایک ٹرانزیکشن میں چلتی ہے جس میں Postgres کا آرگ اسکوپ پرنسپل سے سیٹ ہوتا ہے، لہٰذا تنہائی (isolation) کو ڈیٹا بیس نافذ کرتا ہے، نہ کہ کوئی ORM فلٹر جسے کوئی بھول سکتا ہو۔ کوئری سیٹ فلٹر دفاعی تہہ کے طور پر اب بھی موجود ہے۔
ایک API کو README میں خوبصورت بنانا آسان ہوتا ہے اور اصل ٹریفک کے تحت اسے سنبھالنا مشکل۔ یہ وہ حصے ہیں جن پر ہم نے محنت کی، کیونکہ یہی وہ حصے ہیں جو رات کے تین بجے انٹیگریشنز کو خراب کرتے ہیں۔
ایک تفصیل جسے نمایاں کرنا ضروری ہے، کیونکہ یہ آؤٹ دی باکس بلک کام کے انداز کو مرتب کرتی ہے: ڈپلیکیٹ ڈومین پر 409 کا جواب کسی بھی ٹیننٹ کے لیے اس سوال کا جواب دیتا ہے کہ "کیا یہ ہوسٹ نیم یہاں ہوسٹ شدہ ہے؟"، جو کہ ایک اینومریشن اوریکل ہے اور Footprint-Free کے خلاف ڈی انونیمائزیشن کا ایک حقیقی خطرہ ہے۔ سائٹ کی تخلیق کو تھروٹل کرنا ایک سست حل ہوتا اور یہ بلک پروویژننگ پروڈکٹ کو مکمل طور پر خراب کر دیتا۔ اس کے بجائے صرف مسترد شدہ ڈپلیکیٹ ڈومین کی کوششوں کا بجٹ مقرر کیا جاتا ہے، فی پرنسپل۔ کامیاب تخلیقات پر کبھی بھی چارج نہیں لگایا جاتا — لہذا آپ پورا دن بلک میں پروویژننگ کر سکتے ہیں، اور پروبنگ تقریباً فوری طور پر ختم ہو جاتی ہے۔
تین مختلف کام کرنے کے طریقوں کے لیے، ایک ہی تخصیص کے تین صارفین۔
TypeScript, Python, PHP اور Go کے لیے تیار کردہ، جو اسپیس کی پیروی کرتا ہے تاکہ ایک نیا اینڈ پوائنٹ ہاتھ سے لکھے گئے ریپر کا انتظار کیے بغیر آپ کی زبان میں آ جائے۔
ایک WordPress سائٹ بنائیں، اسے بنا کسی مزید انسٹالیشن کے صرف Node کے ساتھ مقامی طور پر چلائیں، اور پبلش (deploy) کریں۔ Zinnector® آپ کے پروجیکٹ کی اس سلاٹ کے مطابق پیشگی جانچ کرتا ہے جس پر آپ ڈپلائی کرنے والے ہیں — PHP ورژن، ڈسک، فائلوں کی تعداد — اور بعد کے بجائے پہلے ہی خبردار کر دیتا ہے۔ یہ سائن ان کرنے، سائٹس کی فہرست دکھانے، ڈپلائی کرنے، ڈومینز اور DNS کا انتظام کرنے، میل سروسز کو پڑھنے، بیک اپ لینے، اجازت یافتہ WP-CLI چلانے، لاگز کا جائزہ لینے اور یکمشت آپریشنز کو انجام دینے کی سہولت بھی دیتا ہے۔ مفت، MIT-لائسنس یافتہ، اور اسی عوامی API پر تیار کردہ۔
سائٹس، ڈومینز، DNS ریکارڈز، میل باکسز اور پلینز کا انتظام بطور انفراسٹرکچر ایز کوڈ (infrastructure as code) کریں۔ terraform apply ہوسٹنگ کی فراہمی کو یقینی بناتا ہے، اور آپ کے انوائرمنٹس کلکس کی ایسی ترتیب کے بجائے، جسے کسی نے محفوظ نہ کیا ہو، دوبارہ قابلِ تخلیق اور قابلِ جائزہ بن جاتے ہیں۔
تخلیق کردہ دستاویزات جنہیں آپ براؤزر سے پڑھ سکتے ہیں اور کال کر سکتے ہیں، جو بالکل ان اینڈ پوائنٹس کی وضاحت کرتی ہیں جو سرور نافذ کرتا ہے—کیونکہ دونوں ایک ہی تصریح (spec) سے آتے ہیں۔
پلت فارم کے پس پردہ ایک مضبوط ایونٹ اسپائن موجود ہے: ہر اسٹیٹ چینج ڈیٹا بیس کی تبدیلی کے ساتھ ایٹمی طور پر Postgres میں ٹرانزیکشنل آؤٹ باکس میں ایک ایونٹ لکھتا ہے، اور ایک ریلے اسے NATS JetStream پر شائع کرتا ہے۔ ایونٹس ٹائپ اور ورژن شدہ ہوتے ہیں — site.deployed، order.paid، invoice.overdue، backup.completed، abuse.flagged، trial.ending اور باقی تمام۔
ایک اینڈ پوائنٹ کو بطور WebhookSubscription رجسٹر کریں اور ان ایونٹ کی اقسام کا انتخاب کریں جو یہ موصول کرتا ہے۔ ایک ہی اسٹریم نوٹیفیکیشنز، تجزیات، آٹومیشنز اور آپ کے انٹیگریشن کو یکساں طور پر فیڈ کرتا ہے — آپ بالکل وہی ایونٹس استعمال کر رہے ہیں جو ہم کرتے ہیں۔
ہر ڈیلیوری پر HMAC کے دستخط ہوتے ہیں تاکہ عمل کرنے سے پہلے آپ تصدیق کر سکیں کہ یہ ہماری طرف سے آئی ہے۔
فیل ہونے والی ڈیلیوریز بیک آف کے ساتھ دوبارہ کوشش کرتی ہیں اور ہر کوشش بطور WebhookDelivery درج کی جاتی ہے۔ آپ سپورٹ کو یہ ای میل کرنے کے بجائے کہ ہم نے کیا بھیجا تھا، ڈیش بورڈ سے ڈیلیوریز کا معائنہ اور انہیں دوبارہ چلا سکتے ہیں۔
پائپ لائن جان بوجھ کر کم از کم ایک بار (at-least-once) ہے نہ کہ بالکل ایک بار (exactly-once) ہونے کا دعویٰ کرتی ہے۔ اشاعت کے دوران فوت ہونے والے ریلے کی کلیم لیز کی میعاد ختم ہو جاتی ہے اور اس کے ایونٹس دوبارہ شائع ہو جاتے ہیں۔ انویلپ آئی ڈی پر ڈوپلیکیٹ ختم کریں (dedupe) اور آپ کا کنزیومر ساخت کے لحاظ سے درست ہے۔
ایک API ڈویلپر کی کہانی کا صرف نصف حصہ ہے۔ دوسرا نصف حصہ اسے لائیو کرنا ہے۔
ہم اس پلیٹ فارم کو ایک ہوسٹڈ MCP سرور کے طور پر پیش کرتے ہیں: انجن API پر ایک باریک پروٹوکول اڈاپٹر جو بالکل وہی ایکشن کیٹلاگ، RBAC اور آڈٹ ٹریل دوبارہ استعمال کرتا ہے۔ Claude Code، Cursor، ChatGPT، Claude Desktop یا کسی بھی MCP کے قابل کلائنٹ کو ایک بار کنیکٹ کریں، اور ہم API میں جو بھی صلاحیت شامل کریں گے وہ اس کے لیے خود بخود دستیاب ہو جائے گی۔
ایجنٹ کو تین چیزیں ملتی ہیں: ٹولز (وہی API اینڈ پوائنٹس، ڈرفٹ کے لیے کوئی متوازی لاجک نہیں)، ریسورسز (صرف پڑھنے کے قابل سائٹ کی صحت، کنفیگریشن، حالیہ لاگز، میٹرکس، اپ ٹائم اور کے بی آرٹیکلز، تاکہ یہ عمل کرنے سے پہلے حقیقی ڈیٹا کے ساتھ تشخیص کرے) اور پرامپٹس (شائع شدہ ورک فلو ٹیمپلیٹس جیسے "diagnose this site" یا "prepare a migration")۔
سیکیورٹی کی کہانی بھی توثیق جیسی ہی ہے: OAuth 2.1، آپ کی تنظیم سے منسلک ٹوکنز اور رو-لیول سیکیورٹی کے نفاذ کے ساتھ RBAC اجازتیں، جو ہر ٹول کے لیے محدود اور منسوخ کرنے کے قابل ہیں، سینڈ باکس پروڈکشن سے الگ ہے۔ نقصان دہ کارروائیوں—حذف کرنے، معطل کرنے، بلنگ، بڑے اخراجات—کے لیے صریح تصدیق یا انسانی منظوری کی پالیسی درکار ہوتی ہے۔ ریٹ کی حدود اور اخراجات کی حدیں AI سے چلنے والی پیڈ کارروائیوں کو باندھتی ہیں، اور ہر MCP کال شناخت، ٹول، دلائل اور نتیجے کے ساتھ آڈٹ لاگ ہوتی ہے۔
ہم ہر ایک ایپ کو باری باری ضم کرنے کے بجائے پروٹوکول کا ساتھ دیتے ہیں، جس کا مطلب ہے کہ آپ کی ہوسٹنگ کے انٹیگریشن کو تبدیل کیے بغیر آپ کی پسند کے AI ٹولنگ میں تبدیلی آ سکتی ہے۔
ہاں — یہ وہی انجن API ہے، جو شائع شدہ اور مستحکم ہے۔ ڈیش بورڈ، ایڈمن کنسول، CLI، ٹیرافارم پرووائیڈر، MCP سرور اور ویب ہکس سبھی ایک ہی انٹرفیس کے صارف ہیں، یہی وجہ ہے کہ API پینل سے پیچھے نہیں رہتی۔
ہاں۔ سینڈ باکس کی چابیاں پروڈکشن کی چابیوں سے الگ جاری کی جاتی ہیں اور ٹیسٹ موڈ میں چلتی ہیں: کوئی حقیقی بلنگ اور کوئی حقیقی پروویژننگ نہیں۔ اپنی CI کو سینڈ باکس کی اسناد پر پوائنٹ کریں اور محفوظ طریقے سے درخواست اور جواب کے پورے سائیکل کو آزمائیں۔
اپنے POST پر ایک Idempotency-Key بھیجیں۔ ری پلے کا ریکارڈ ان لائن کے بجائے کمیٹ پر لکھا جاتا ہے، اس لیے دوبارہ کوشش کرنے پر کبھی بھی اس قطار کے لیے کیش کی گئی کامیابی کا ری پلے نہیں ہوگا جو درحقیقت کمیٹ نہیں ہوئی تھی، اور ناکام ہونے والی درخواست اپنا لاک فوراً جاری کر دیتی ہے تاکہ آپ کی درست کردہ دوبارہ کوشش کو روکا نہ جائے۔ ویب ہک کی ترسیل ڈیزائن کے لحاظ سے کم از کم ایک بار ہوتی ہے — اپنے پاس انویلپ آئی ڈی پر ڈیڈوپ کریں۔
آج نہیں۔ API کیز ہر آرگنائزیشن کے لیے جاری کی جاتی ہیں، لہذا کئی کلائنٹ آرگنائزیشنز پر محیط انٹیگریشن کے پاس ہر ایک کے لیے ایک کی ہوتی ہے۔ یوزر پرنسپلز کے لیے اجازتیں بھی فی آرگنائزیشن چیک کی جاتی ہیں: ایک آرگنائزیشن میں sites.create رکھنے سے کسی دوسری، غیر متعلقہ آرگنائزیشن تک کوئی رسائی نہیں ملتی، حالانکہ یہ اس کے نیچے نیسٹڈ آرگنائزیشنز پر لاگو ہوتی ہے۔ یہ جان بوجھ کر کیا گیا ہے — یہ کمپرومائزڈ کی کو پوری پلیٹ فارم کے بجائے صرف اس کی اپنی آرگنائزیشن اور اس کے تحت موجود سب آرگنائزیشنز تک محدود کرتا ہے۔
Dev کا کردار تنظیم کے مطالعے، API کی کلید کے انتظام، سائٹس کو دیکھنے اور تخلیق کرنے، انہیں دوبارہ شروع کرنے، ان کے کیش کو صاف کرنے، اور ٹکٹس دیکھنے اور ان کا جواب دینے کا احاطہ کرتا ہے۔ اس میں جان بوجھ کر بلنگ کا کنٹرول شامل نہیں ہے۔ یاد رکھیں کہ تعیناتی (deploy) اور لائیو پر پش کرنے (push-to-live) کی اجازتیں اس کا حصہ نہیں ہیں — اگر کسی ٹیم کے رکن کو ان کی ضرورت ہو، تو ڈویلپر کو سب سے وسیع تکنیکی کردار سمجھنے کے بجائے ایسا کردار تفویض کریں جو یہ اجازتیں رکھتا ہو۔
ڈیلیوریز بیک آف کے ساتھ دوبارہ کوشش کرتی ہیں اور ہر کوشش بطور WebhookDelivery ریکارڈ کی جاتی ہے جسے آپ معائنہ کر سکتے ہیں۔ اپ اسٹریم پر، ایونٹس کو تبدیلی کے ساتھ ہی ڈیٹا بیس کے اسی ٹرانزیکشن میں ایک ٹرانزیکشنل آؤٹ باکس میں لکھا جاتا ہے، لہذا جب کوئی کنزیومر دستیاب نہ ہو تو کچھ بھی ضائع نہیں ہوتا — ایک ڈاؤن کنزیومر پیچھے رہ جاتا ہے، یہ کبھی پروڈیوسر کو نہیں توڑتا، اور واپس آنے کے بعد آپ ڈیش بورڈ سے ڈیلیوریز کو دوبارہ چلا سکتے ہیں۔
Footprint-Free Hosting کے 14 دن کے کارڈ کے بغیر ٹرائل کا آغاز کریں — ادائیگی کی تفصیلات کی ضرورت نہیں، 5 سائٹس تک۔ پی بی این 5 (PBN 5) کے لیے پیڈ Footprint-Free درجے $6/ماہ سے شروع ہوتے ہیں۔ ہر پلان میں 30 دن کیپیس-بییک گارنٹی، مفت مائیگریشنز اور کوئی وینڈر لاک ان شامل نہیں ہے۔
پہلے تفصیل (spec) پر مبنی API، تیار کردہ SDKs، ایک CLI، ایک Terraform فراہم کنندہ، دستخط شدہ ویب ہکس اور ایک MCP سرور—اس ہوسٹنگ پر جو ہم نے دنیا بھر میں 650,000 سے زائد سائٹس کے لیے بنائی ہے۔ کریڈٹ کارڈ کے بغیر 14 دن کے مفت ٹرائل کا آغاز کریں، ادائیگی کی کوئی تفصیلات درکار نہیں۔
مفت شروع کریں