ڈویلپرز کے لیے
Zinn Digital® ایک API-first پلیٹ فارم ہے۔ انجن کا وہی API جو ہمارے ڈیش بورڈ کو چلاتا ہے وہی ہے جو آپ کو ملتا ہے — ورژن شدہ، وضاحتی ترجیح پر مبنی اور بناتے وقت 100% دستاویزی شکل دیا گیا، جس میں تیار کردہ SDKs، ایک CLI، ایک Terraform فراہم کنندہ، دستخط شدہ ویب ہکس اور اس کے اوپر ایک MCP سرور موجود ہے۔ کام کرنے کے لیے آپ جو بھی استعمال کریں — ایک ٹرمینل، ایک پائپ لائن، ایک اسٹیٹ فائل یا ایک AI ایجنٹ — پلیٹ فارم اس کا جواب دیتا ہے۔
زیادہ تر ہوسٹس بعد میں کنٹرول پینل پر ایک API جوڑ دیتے ہیں، اور یہ واضح نظر آتا ہے — پینل کے نصف فیچرز کبھی باہر نہیں آپاتے۔ ہم نے اس کے برعکس تعمیر کی ہے۔ ڈیش بورڈ، ایڈمن کنسول، CLI، Terraform فراہم کنندہ، MCP سرور اور آپ کے اپنے انضمام سب ایک ہی انجن API کا استعمال کرتے ہیں۔ اگر آپ اسے پینل میں کر سکتے ہیں، تو آپ اسے کوڈ میں بھی کر سکتے ہیں۔
OpenAPI تصریح حقیقت کا واحد ذریعہ ہے، اور کوئی بھی اینڈپوائنٹ اس وقت تک جاری نہیں کیا جاتا جب تک کہ وہ تصریح میں موجود نہ ہو۔ یہی ایک اصول عوامی API کو بعد میں کسی وقت کے بجائے بلڈ کے وقت ہی مکمل طور پر دستاویزی بناتا ہے — کوئی بھی غیر دستاویزی گوشہ نہیں ہے، کیونکہ غیر دستاویزی اینڈپوائنٹ کا وجود ہی ممکن نہیں ہے۔
انٹرایکٹو حوالہ جاتی دستاویزات، چار کلائنٹ SDKs، زیادہ تر CLI اور Terraform فراہم کنندہ کا سہاربنڈی سبھی اسی ایک تصریح سے تیار کیے گئے ہیں۔ ایک ذریعہ، کئی نوادرات، ہمیشہ ہم آہنگ — آپ کو کبھی بھی ایسی دستاویز کے پیچھے نہیں بھاگنا پڑتا جو نفاذ سے ہٹ گئی ہو۔
اینڈ پوائنٹس ایک شائع شدہ متروکیت کی پالیسی اور تبدیلی کے لاگ کے ساتھ /v1 کے تحت دستیاب ہیں۔ ناکام بلڈ سے معلوم ہونے کے بجائے، کسی بھی تبدیلی سے پہلے آپ کو تحریری طور پر مطلع کیا جاتا ہے۔
ہر تبدیلی پر نفاذ بمقابلہ تصریح کے معاہداتی ٹیسٹ اور OpenAPI لِنٹنگ چلتے ہیں۔ کوڈ اور معاہدے کے درمیان فرق تعمیر کو ناکام بنا دیتا ہے — چنانچہ جس تصریح سے آپ اپنا کلائنٹ تیار کرتے ہیں وہی تصریح سرور درحقیقت تسلیم کرتا ہے۔
داخلے کے دو طریقے، ان کے پیچھے ایک یکساں اصول۔ آپ خواہ کوئی بھی طریقہ استعمال کریں، یکساں اجازت کی جانچ اور ڈیٹا بیس کی سطح پر یکساں تنہائی لاگو ہوتی ہے۔
کلیدیں zdk_<mode>_<prefix>_<secret> کی مانند دکھائی دیتی ہیں۔ خفیہ حصے کا صرف ایک SHA-256 ہیش محفوظ کیا جاتا ہے — جاری ہونے کے بعد ہم آپ کو دوبارہ کلید نہیں دکھا سکتے، اور نہ ہی ہمارے ڈیٹا بیس تک رسائی حاصل کرنے والا کوئی اور ایسا کر سکتا ہے۔ کلیدوں کے دائرہ کار ہوتے ہیں، انہیں منسوخ کیا جا سکتا ہے، اور یہ فرد کے بجائے فی تنظیم جاری کی جاتی ہیں۔
سینڈ باکس کلیدیں پیداواری کلیدوں سے الگ ہوتی ہیں اور سینڈ باکس موڈ پر چلتی ہیں: کوئی حقیقی بلنگ نہیں، کوئی حقیقی وسائل کی فراہمی نہیں۔ آپ کے انضمام کے ٹیسٹ پیسے خرچ کیے بغیر یا سرورز بنائے بغیر API پر بھاری بوجھ ڈال سکتے ہیں۔
صارف کے سیشنز Keycloak کے جاری کردہ JWTs کے ساتھ تصدیق کرتے ہیں، جنہیں realm پبلک کی کے ذریعے جانچا جاتا ہے، اور یہ اسی Principal آبجیکٹ پر حل ہوتے ہیں جس پر ایک API کی حل ہوتی ہے۔ اینڈ پوائنٹس تفصیلی اجازت کیز جیسے کہ sites.create یا apikeys.manage پر گیٹ کیے جاتے ہیں، جن کی جانچ فی تنظیم کی جاتی ہے — ایک تنظیم میں اجازت کسی الگ، غیر متعلقہ تنظیم میں کوئی رسائی نہیں دیتی، اگرچہ یہ اس کے ماتحت اندرونی تنظیموں پر لاگو ہوتی ہے۔
کرایہ دار کی ہر درخواست پرنسپل سے سیٹ کردہ Postgres org کے دائرہ کار کے ساتھ ایک ٹرانزیکشن میں چلتی ہے، اس لیے تنہائی ڈیٹا بیس کے ذریعے نافذ کی جاتی ہے، نہ کہ کسی ایسے ORM فلٹر کے ذریعے جسے کوئی بھول سکتا ہے۔ گہرائی میں دفاع کے طور پر queryset فلٹر اب بھی وہاں موجود ہے۔
کسی README میں API کو اچھا دکھانا آسان ہے اور حقیقی ٹریفک کے تحت اسے درست طریقے سے چلانا مشکل ہے۔ یہ وہ حصے ہیں جن پر ہم نے سخت محنت کی ہے، کیونکہ یہی وہ حصے ہیں جو رات کے تین بجے انضمام کو خراب کرتے ہیں۔
ایک تفصیل جس کا ذکر کرنا ضروری ہے، کیونکہ یہ طے کرتی ہے کہ بلک کام کس طرح انجام پاتا ہے: ڈپلیکیٹ ڈومین پر 409 کا ایرر کسی بھی کرایہ دار کے لیے اس سوال کا جواب دیتا ہے کہ "کیا یہ ہوسٹ نیم یہاں ہوسٹ ہے؟"، جو کہ ایک اینومریشن اوریکل اور Footprint-Free کے خلاف غیر شناخت کاری کا حقیقی خطرہ ہے۔ سائٹ کی تخلیق کو محدود کرنا ایک سست روی پر مبنی حل ہوتا اور یہ بلک پروویژننگ پراڈکٹ کو مکمل طور پر خراب کر دیتا۔ اس کے بجائے صرف مسترد شدہ ڈپلیکیٹ ڈومین کی کوششوں کے لیے فی پرنسپل حد مقرر کی گئی ہے۔ کامیاب تخلیقات کو اس کے تحت کبھی بھی شمار نہیں کیا جاتا — چنانچہ آپ سارا دن بلک میں پروویژن کر سکتے ہیں، اور غیر مجاز جانچ پڑتال تقریباً فوری طور پر بند ہو جاتی ہے۔
کام کے تین مختلف طریقوں کے لیے، ایک ہی تفصیلات کے تین صارفین۔
TypeScript، Python، PHP اور Go کے لیے تیار کیا گیا، جو تفصیلات کو ٹریک کرتا ہے تاکہ ہاتھ سے لکھے گئے ریپر کا انتظار کیے بغیر ایک نیا اینڈ پوائنٹ آپ کی زبان میں پہنچ جائے۔
ایک WordPress سائٹ کا ڈھانچہ تیار کریں، Node کے علاوہ کچھ بھی انسٹال کیے بغیر اسے مقامی طور پر چلائیں، اور اسے تعینات کریں۔ Zinnector® آپ کے پروجیکٹ کی اس سلاٹ کے مطابق پیشگی جانچ کرتا ہے جس پر آپ تعینات کرنے والے ہیں — PHP ورژن، ڈسک، فائلوں کی تعداد — اور بعد کے بجائے آپ کے پش کرنے سے پہلے خبردار کرتا ہے۔ یہ سائن ان بھی کرتا ہے، سائٹس کی فہرست بناتا ہے، تعینات کرتا ہے، ڈومینز اور DNS کا انتظام کرتا ہے، میل سروسز پڑھتا ہے، بیک اپ لیتا ہے، اجازت یافتہ فہرست میں شامل WP-CLI چلاتا ہے، لاگز پر لائیو نظر رکھتا ہے اور بیک وقت کئی آپریشنز انجام دیتا ہے۔ مفت، MIT لائسنس یافتہ، اور اسی عوامی API پر بنایا گیا۔
سائٹس، ڈومینز، DNS ریکارڈز، میل باکسز اور پلینز کا انفراسٹرکچر ایز کوڈ کے طور پر انتظام کریں۔ terraform apply ہوسٹنگ فراہم کرتا ہے، اور آپ کے ماحول بغیر لکھے گئے کلکس کے سلسلے کے بجائے دوبارہ قابل تخلیق اور قابل جائزہ بن جاتے ہیں۔
تیار کردہ دستاویزات جنہیں آپ براؤزر سے پڑھ اور کال کر سکتے ہیں، جو سرور کے ذریعے نافذ کردہ اینڈ پوائنٹس کو بالکل درست بیان کرتی ہیں — کیونکہ دونوں ایک ہی تفصیلات سے آتے ہیں۔
اس پلیٹ فارم کے پیچھے ایک پائیدار ایونٹ اسپائن موجود ہے: ہر اسٹیٹ کی تبدیلی ڈیٹا بیس کی تبدیلی کے ساتھ ایٹمی طور پر Postgres میں ایک ٹرانزیکشنل آؤٹ باکس میں ایونٹ لکھتی ہے، اور ایک ریلے اسے NATS JetStream پر شائع کرتا ہے۔ ایونٹس ٹائپ شدہ اور ورژن شدہ ہوتے ہیں — site.deployed، order.paid، invoice.overdue، backup.completed، abuse.flagged، trial.ending اور باقی تمام۔
ایک اینڈ پوائنٹ کو بطور WebhookSubscription رجسٹر کریں اور اس کے موصول ہونے والے ایونٹ کی اقسام منتخب کریں۔ ایک سلسلہ اطلاعات، تجزیات، خودکار طریقہ کار اور آپ کے انضمام کو یکساں طور پر فیڈ فراہم کرتا ہے — آپ انہی ایونٹس کو استعمال کر رہے ہیں جو ہم کرتے ہیں۔
ہر ترسیل HMAC سے دستخط شدہ ہوتی ہے تاکہ آپ اس پر عمل کرنے سے پہلے تصدیق کر سکیں کہ یہ ہماری طرف سے ہی آئی ہے۔
ناکام ڈیلیوریز کی بتدریج وقفے کے ساتھ دوبارہ کوشش کی جاتی ہے اور ہر کوشش کو WebhookDelivery کے طور پر ریکارڈ کیا جاتا ہے۔ آپ سپورٹ کو ای میل کر کے یہ پوچھنے کے بجائے کہ ہم نے کیا بھیجا ہے، ڈیش بورڈ سے ڈیلیوریز کا معائنہ کر سکتے ہیں اور انہیں دوبارہ چلا سکتے ہیں۔
پائپ لائن جان بوجھ کر بالکل ایک بار ہونے کا ڈراما کرنے کے بجائے کم از کم ایک بار ہے۔ ایک ریلے جو پبلشنگ کے درمیان میں ہی ختم ہو جائے اس کی دعوے کی لیز ختم ہو جاتی ہے اور اس کے ایونٹس دوبارہ شائع ہو جاتے ہیں۔ envelope id پر نقل کو دور کریں اور آپ کا کنزیومر ساخت کے لحاظ سے بالکل درست ہے۔
ایک API ڈویلپر کی کہانی کا صرف آدھا حصہ ہے۔ دوسرا آدھا حصہ اسے لانچ کرنا ہے۔
API ایک دروازہ ہے۔ یہ باقی چار ہیں، اور ان میں سے ہر ایک کو ڈویلپر درجے کے طور پر فروخت کرنے کے بجائے پلان میں شامل کیا گیا ہے۔
براؤزر میں VS Code، جو ڈیش بورڈ میں سائٹ کے صفحے سے کھلتا ہے، پہلے سے شامل git اور آپ کی SFTP رسائی والی اسی CageFS قید کے اندر پورے ایڈیٹر کے ساتھ اس سائٹ کی اصل فائلوں میں ترمیم کرتا ہے۔ یہ لائیو سائٹ میں ترمیم کرتا ہے — درمیان میں کوئی اسٹیجنگ کاپی نہیں ہوتی، لہذا آپ کی محفوظ کردہ فائل لکھے جانے کے فوراً بعد عوامی ہو جاتی ہے، اگرچہ ایک جامد فائل چار گھنٹے تک CDN کیشے سے پیش کی جا سکتی ہے۔
مفت، MIT کے تحت لائسنس یافتہ اور اسی عوامی API پر بنایا گیا۔ ایک WordPress سائٹ کا ڈھانچہ تیار کریں، اسے اپنی مشین پر چلائیں، جس سلاٹ پر آپ اسے تعینات کرنے والے ہیں اس کے مطابق پہلے سے جانچیں — PHP ورژن، ڈسک، فائلوں کی تعداد — اور تعینات کریں۔ Node 24 یا نیا ورژن درکار ہے۔
ٹولز کا ایک کیٹلاگ، تاکہ آپ کا پہلے سے استعمال شدہ AI کلائنٹ اسی API اور انہی اجازتوں کے ذریعے آپ کی سائٹس پر کام کر سکے جو ڈیش بورڈ استعمال کرتا ہے۔ وہی سرور جس سے آپ کا اپنا کلائنٹ کنیکٹ ہوتا ہے وہی ویب ایڈیٹر سے منسلک ہے۔ صرف پڑھنے کے لیے جب تک کہ آپ دوسری صورت میں ہدایت نہ دیں۔
کلائنٹ کے کام کے لیے آپ کے پاس ورڈ کی ضرورت نہیں ہے۔ کسی کو ای میل ایڈریس کے ذریعے مدعو کریں اور انہیں بالکل ایک ہی سائٹ ملتی ہے: وہ مبصر، ایڈیٹر یا مینیجر کے کردار کے ساتھ اپنی حیثیت میں سائن ان کرتے ہیں، اور کوئی بھی ہینڈلر چلنے سے پہلے باقی ہر سائٹ 404 جواب دیتی ہے — یہ صرف ایک جانچ نہیں بلکہ ایک Postgres قطار کی سطح کی سیکیورٹی پالیسی اور درخواست کی سطح کی باڑ ہے۔ اکاؤنٹ کا مالک اسے ایک کلک میں تفویض کرتا اور منسوخ کرتا ہے، جو ان کی اگلی درخواست سے ہی موثر ہوتا ہے۔
ہم پلیٹ فارم کو ایک ہوسٹڈ MCP سرور کے طور پر پیش کرتے ہیں: انجن API پر ایک پتلا پروٹوکول اڈاپٹر جو بالکل یکساں ایکشن کیٹلاگ، RBAC اور آڈٹ ٹریل کو دوبارہ استعمال کرتا ہے۔ ایک بار Claude Code، Cursor، ChatGPT، Claude Desktop یا کسی بھی MCP کی صلاحیت رکھنے والے کلائنٹ کو مربوط کریں، اور جو بھی صلاحیت ہم API میں شامل کرتے ہیں وہ خود بخود اس کے لیے دستیاب ہو جاتی ہے۔
ایجنٹ کو تین چیزیں ملتی ہیں: ٹولز (وہی API اینڈ پوائنٹس، انحراف کے لیے کوئی متوازی منطق نہیں)، وسائل (صرف پڑھنے کے لیے سائٹ کی صحت، کنفیگریشن، حالیہ لاگز، میٹرکس، اپ ٹائم اور KB مضامین، تاکہ یہ عمل کرنے سے پہلے حقیقی ڈیٹا کے ساتھ تشخیص کرے) اور پرامپٹس (شائع شدہ ورک فلو ٹیمپلیٹس جیسے کہ "اس سائٹ کی تشخیص کریں" یا "منتقلی کی تیاری کریں")۔
حفاظت بھی بالکل تصدیق (authentication) کی طرح ہی ہے: OAuth 2.1، ٹوکنز جو آپ کی تنظیم (org) سے وابستہ ہیں، اور لاگو کردہ قطار کی سطح کی سیکیورٹی (row-level security) کے ساتھ RBAC اجازتیں، جو ہر ٹول کے مطابق محدود اور منسوخ کی جا سکتی ہیں، اور پروڈکشن سے الگ سینڈ باکس۔ تباہ کن اقدامات — ڈیلیٹ کرنا، معطل کرنا، بلنگ، بڑے اخراجات — کے لیے واضح تصدیق یا انسانی منظوری کی پالیسی درکار ہوتی ہے۔ شرح کی حدیں (rate limits) اور اخراجات کی حدیں AI سے شروع ہونے والے بامعاوضہ اقدامات کو محدود کرتی ہیں، اور ہر MCP کال کو شناخت، ٹول، دلائل (arguments) اور نتیجے کے ساتھ آڈٹ لاگ کیا جاتا ہے۔
ہم ہر ایپ کو فرداً فرداً مربوط کرنے کے بجائے پروٹوکول کو سپورٹ کرتے ہیں، جس کا مطلب ہے کہ آپ کی ہوسٹنگ انٹیگریشن کو تبدیل کیے بغیر آپ کے AI ٹولز کا انتخاب تبدیل ہو سکتا ہے۔
جی ہاں — یہ وہی انجن API ہے، جسے شائع اور مستحکم کیا گیا ہے۔ ڈیش بورڈ، ایڈمن کنسول، CLI، Terraform فراہم کنندہ، MCP سرور اور ویب ہُکس سبھی ایک ہی انٹرفیس کے صارفین ہیں، اسی لیے API پینل سے پیچھے نہیں رہتا۔
جی ہاں۔ سینڈ باکس کلیدیں پروڈکشن کلیدوں سے الگ جاری کی جاتی ہیں اور ٹیسٹ موڈ میں کام کرتی ہیں: نہ کوئی حقیقی بلنگ اور نہ ہی کوئی حقیقی فراہمی۔ اپنے CI کا رخ سینڈ باکس کی اسناد کی طرف کریں اور درخواست اور جواب کے مکمل چکر کی محفوظ طریقے سے جانچ کریں۔
اپنی POST درخواست پر Idempotency-Key بھیجیں۔ ری پلے کا ریکارڈ inline کے بجائے commit پر لکھا جاتا ہے، لہٰذا دوبارہ کوشش کرنے پر کبھی بھی ایسی قطار کے لیے کیش شدہ کامیابی کو ری پلے نہیں کیا جا سکتا جو درحقیقت commit نہ ہوئی ہو، اور ناکام ہونے والی درخواست فوری طور پر اپنے لاک کو جاری کر دیتی ہے تاکہ آپ کی درست کردہ دوبارہ کوشش رکی نہ رہے۔ Webhook کی ترسیل ڈیزائن کے لحاظ سے کم از کم ایک بار (at-least-once) ہوتی ہے — اپنے پاس envelope id پر نقل کو دور (dedupe) کریں۔
آج نہیں۔ API کیز ہر تنظیم کے لیے جاری کی جاتی ہیں، اس لیے کئی کلائنٹ تنظیموں پر مشتمل ایک انضمام ہر ایک کے لیے ایک کلید رکھتا ہے۔ صارف کے اصولوں کے لیے اجازتیں بھی فی تنظیم چیک کی جاتی ہیں: ایک تنظیم میں sites.create کا ہونا ایک الگ، غیر متعلقہ تنظیم میں کوئی رسائی نہیں دیتا، حالانکہ یہ اس کے نیچے موجود تنظیموں پر لاگو ہوتا ہے۔ یہ جان بوجھ کر کیا گیا ہے — یہ ایک سمجھوتہ شدہ کلید کو اس کی اپنی تنظیم اور اس کے ماتحت ذیلی تنظیموں تک محدود رکھتا ہے، نہ کہ پورے پلیٹ فارم تک۔
dev کا کردار تنظیم کا مطالعہ، API کلیدوں کا انتظام، سائٹس کو دیکھنا اور بنانا، انہیں دوبارہ شروع کرنا، ان کا کیشے صاف کرنا، اور ٹکٹس کو دیکھنا اور ان کا جواب دینا شامل کرتا ہے۔ یہ جان بوجھ کر بلنگ کنٹرول کو خارج کرتا ہے۔ یاد رکھیں کہ ڈیپلوائے اور پش ٹو لائیو کے اختیارات اس کا حصہ نہیں ہیں — اگر ٹیم کے کسی رکن کو ان کی ضرورت ہو، تو یہ فرض کرنے کے بجائے کہ Developer سب سے وسیع تکنیکی کردار ہے، ایسا کردار تفویض کریں جس میں یہ شامل ہوں۔
ترسیلات وقفے کے بتدریج اضافے کے ساتھ دوبارہ کوشش کی جاتی ہیں اور ہر کوشش کو ایک WebhookDelivery کے طور پر ریکارڈ کیا جاتا ہے جس کا آپ معائنہ کر سکتے ہیں۔ اپ اسٹریم میں، ایونٹس کو اسی ڈیٹابیس ٹرانزیکشن میں ایک ٹرانزیکشنل آؤٹ باکس میں لکھا جاتا ہے جس میں خود تبدیلی ہوتی ہے، اس لیے جب کوئی صارف دستیاب نہ ہو تو کچھ بھی ضائع نہیں ہوتا ہے — ایک غیر فعال صارف پیچھے رہ جاتا ہے، یہ کبھی پروڈیوسر کو متاثر نہیں کرتا ہے، اور آپ واپس آنے پر ڈیش بورڈ سے ترسیلات کو دوبارہ چلا سکتے ہیں۔
Footprint-Free ہوسٹنگ کے کارڈ کے بغیر 14 دن کے ٹرائل سے شروعات کریں — ادائیگی کی کوئی تفصیلات نہیں، 5 سائٹس تک۔ بامعاوضہ Footprint-Free درجات PBN 5 کے لیے $6 فی ماہ سے شروع ہوتے ہیں۔ ہر پلان میں 30 دن کی رقم واپسی کی گارنٹی، مفت منتقلی اور وینڈر لاک ان کی عدم موجودگی شامل ہے۔
تفصیلات کی بنیاد پر تیار کردہ API، جنریٹ کردہ SDKs، ایک CLI، ایک Terraform فراہم کنندہ، دستخط شدہ ویب ہکس اور ایک MCP سرور — اس ہوسٹنگ پر جسے ہم نے دنیا بھر کی 700,000 سے زائد سائٹس کے لیے بنایا ہے۔ ادائیگی کی تفصیلات کے بغیر، کارڈ کے بغیر 14 دن کے آزمائشی دور سے آغاز کریں۔
مفت شروع کریںان میں سے ہر ایک پلگ ان آپ کی WordPress سائٹ کو ایک MCP سرور بناتا ہے، تاکہ Claude، Cursor، VS Code اور دیگر AI اسسٹنٹس اس پر آپ کے طور پر سائن ان ہو کر اور آپ کے مجاز دائرہ کار تک محدود رہتے ہوئے اصل کام کر سکیں۔