د پراختیا کونکو لپاره
Zinn Digital® یو د API-لومړیتوب پلیټفارم دی. د انجن هماغه 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 هش ساتل کیږي — موږ نشو کولی د صادرولو وروسته تاسو ته بیا کیلي وښیو، او نه هم هغه څوک چې زموږ ډیټابیس ته لاسرسی ومومي. کیليګانې ساحې لري، لغوه کیدی شي، او د شخص پر ځای د هرې ادارې لپاره صادرېږي.
د Sandbox کیلې د production له کیلو څخه جلا دي او په sandbox حالت کې چلیږي: هیڅ اصلي بیلینګ نشته، هیڅ اصلي سرچینې چمتو کول نشته. ستاسو د ادغام ازموینې کولی شي پرته له پیسو مصرفولو یا سرورونو جوړولو څخه په API باندې شدید غوښتنې پلي کړي.
د کارونکي ناستې د Keycloak لخوا صادر شوي JWTs سره تایید کیږي، د realm عامه کیلي په وړاندې کتل کیږي، او ورته Principal آبجیکټ ته حل کیږي لکه څنګه چې د API کیلي کوي. انډپواینټونه په تفصیلي اجازې کیلیو پورې تړلي دي لکه sites.create یا apikeys.manage، چې د هر سازمان له مخې کتل کیږي — په یوه سازمان کې اجازه په یو جلا، غیر اړونده سازمان کې هیڅ لاسرسی نه ورکوي، که څه هم دا د هغې لاندې سازمانونو باندې پلي کیږي.
د هر کرایه کوونکي (ټیننټ) غوښتنه په یوه راکړه ورکړه (transaction) کې پرمخ ځي چې د Postgres سازمان ساحه پکې له پرنسيپل څخه ټاکل شوې وي، نو ځکه جلاوالی د ډیټابیس لخوا پلي کیږي، نه د ORM فلټر لخوا چې ممکن څوک یې هېر کړي. د queryset فلټر لاهم د څو پوړیزې دفاع په توګه شتون لري.
په یو README کې د API ښه ښکاره کول اسانه دي او د ریښتیني ترافیک لاندې د هغې سم کارول ستونزمن دي. دا هغه برخې دي چې موږ پرې ډېر زیار ایستلی دی، ځکه چې دا هغه برخې دي چې د سهار په دریو بجو ادغامونه خرابوي.
یو تفصیل چې د یادولو وړ دی، ځکه دا ټاکي چې ډله يیز کار څنګه ترسره کېږي: په تکراري ډومین کې 409 د هر کرایه دار لپاره دې پوښتنې ته ځواب ورکوي چې "ایا دا د کوربه نوم دلته کوربه شوی دی؟"، چې دا یو تفتیشي اوراکل (enumeration oracle) او د Footprint-Free پر وړاندې د هویت ښکاره کولو یو ریښتینی خطر دی. د سایټ جوړولو محدودول (throttling) یو اسانه او ناسم حل و او د ډله ییز چمتو کولو (bulk-provisioning) محصول یې په بشپړ ډول خراباوه. پرځای یې، یوازې د تکراري ډومین رد شوې هڅې د هر پرنسیپل لپاره په بودیجه کې حسابېږي. بریالي جوړښتونه هېڅکله له دې څخه نه کمېږي — نو تاسو کولی شئ ټوله ورځ په ډله ییزه توګه پروویژن وکړئ، او جاسوسي کوونکې هڅې سمدستي شنډېږي.
د کار کولو دریو مختلفو لارو لپاره، د ورته مشخصاتو درې مصرفوونکي.
د TypeScript، Python، PHP او Go لپاره جوړ شوی، مشخصات تعقیبوي ترڅو یو نوی پای ټکی د لاس لیکل شوي ریپر ته له انتظار پرته ستاسو ژبې ته ورسیږي.
د WordPress سایټ چمتو کړئ، پرته له Node څخه د بل څه له لګولو پرته یې په سیمه ییزه توګه پرمخ بوځئ، او ویې واستوئ. Zinnector® ستاسو پروژه د هغه سلاټ په وړاندې مخکې له مخکې ارزوي چې تاسو یې د استولو په حال کې یاست — د PHP نسخه، ډیسک، د فایلونو شمیر — او وروسته نه، بلکې مخکې له دې چې تاسو یې پش کړئ خبرداری درکوي. دا ننوځي، سایټونه لست کوي، استوي، ډومینونه او DNS اداره کوي، د بریښنالیک خدمتونه لولي، بیک اپ اخلي، اجازه ورکړل شوی WP-CLI پرمخ وړي، لاګونه څاري او په ډله ییزه توګه عملیات ترسره کوي. وړیا، د MIT لاندې جواز لرونکی، او په همدې عامه API باندې جوړ شوی.
سایټونه، ډومینونه، د DNS ریکارډونه، میل بکسونه او پلانونه د کوډ په بڼه د زیربنا (infrastructure as code) په توګه اداره کړئ. terraform apply کوربه توب برابروي، او ستاسو چاپیریال د هغو کلیکونو د لړۍ پر ځای چې چا نه وي لیکلي، بیا تولیدیدونکی او د بیاکتنې وړ ګرځي.
جوړ شوي اسناد چې تاسو یې له براوزر څخه لوستلی او غوښتنه ورته کولی شئ، په دقیق ډول هغه پای ټکي بیانوي چې سرور یې پلي کوي — ځکه چې دواړه له ورته مشخصاتو څخه راځي.
د پلیټفارم تر شا د پېښو یو دوامدار چورلیز دی: هر حالت بدلون په اتومي ډول د ډیټابیس له بدلون سره په Postgres کې یوه پېښه په یوه معاملهاي outbox کې لیکي، او یو ریلې یې 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 بند کې دننه دی. دا د ژوندي (LIVE) سایټ ایډیټ کوي — په منځ کې یې د سټیجنګ هېڅ کاپي نشته، نو هغه فایل چې تاسو یې خوندي کوئ په هماغه شیبه چې ولیکل شي عامه کیږي، که څه هم یو سټاټیک فایل ممکن تر څلورو ساعتونو پورې د CDN له کیش څخه وړاندې کیدو ته دوام ورکړي.
وړیا، د MIT لاندې جواز لرونکی او په همدې عامه API جوړ شوی. د WordPress سایټ چوکاټ جوړ کړئ، هغه په خپل کمپیوټر کې چل کړئ، د هغه ځای سره یې تر استولو وړاندې وڅارئ چې ورته یې استوئ — د PHP بڼه، ډیسک، د فایلونو شمېر — او ویې استوئ. د Node 24 یا نوې بڼې ته اړتیا لري.
د وسیلو یو کټالوګ، ترڅو هغه د AI کلینټ چې تاسو یې دمخه کاروئ وکولی شي ستاسو په سایټونو کې د ورته API او ورته اجازو له لارې کار وکړي چې ډشبورډ یې کاروي. ورته سرور چې ستاسو خپل کلینټ ورسره نښلي هغه دی چې په ویب اډیټر کې وصل دی. یوازې لوستل کیږي تر هغه چې تاسو بل ډول ووایاست.
د پیرودونکي کار ستاسو پټنوم ته اړتیا نلري. یو څوک د بریښنالیک پته له لارې راوبلئ او هغوی ته به یوازې یو سایټ ورکړل شي: هغوی د لیدونکي، ایډیټر، یا مدیر په رول کې د خپل ځان په توګه ننوځي، او هر بل سایټ مخکې له دې چې کوم هینډلر چل شي 404 ځواب ورکوي — دا د Postgres د قطار په کچه امنیتي تګلاره او د غوښتنې په کچه کټاره ده، نه یوازې یو چک. د حساب مالک دا په یو کلیک سره ورکوي او لغوه کوي، چې د دوی په راتلونکې غوښتنه کې سمدلاسه پلي کیږي.
موږ دا پلیټفارم د کوربه شوي MCP سرور په توګه وړاندې کوو: د انجن API پر سر یو پتلی پروتوکول اډاپټر چې ورته عمل کتلاګ، RBAC او د تفتیش لاره بیا کاروي. Claude Code، Cursor، ChatGPT، Claude Desktop یا هر هغه پیرودونکی چې د MCP وړتیا لري یو ځل وصل کړئ، او هر هغه وړتیا چې موږ یې API ته اضافه کوو په اتوماتيک ډول ورته د لاسرسي وړ ګرځي.
اجنټ درې شیان ترلاسه کوي: Tools (ورته د API پای ټکي، هیڅ موازي منطق شتون نلري چې بې لارې شي)، Resources (یوازې لوستلو وړ د سایټ روغتیا، ترتیبات، وروستي لاګونه، میټریکونه، د فعالیت وخت او د KB مقالې، ترڅو دا د اقدام کولو دمخه د اصلي معلوماتو سره تشخیص وکړي) او Prompts (خپاره شوي د کاري جریان ټیمپلیټونه لکه "diagnose this site" یا "prepare a migration").
خوندیتوب کټ مټ د تصدیق په څېر دی: OAuth 2.1، ستاسو له سازمان سره تړل شوي ټوکنونه او د قطار په کچه د پلي شوي امنیت سره د RBAC اجازې، د هرې وسیلې لپاره محدودې او د لغوه کېدو وړ، او له تولید څخه جلا شوی سنډباکس. ویجاړونکي اقدامات — ړنګول، تعلیق کول، بیلینګ، لوی لګښتونه — ښکاره تایید یا د انساني تصویب پالیسۍ ته اړتیا لري. د نرخ محدودیتونه او د لګښت چتونه د مصنوعي استخباراتو لخوا رامینځته شوي تادیه شوي اقدامات محدودوي، او د هر MCP کال د هویت، وسیلې، استدلالونو او پایلې سره ثبت کیږي.
موږ د هر اپلیکیشن د یو یو مدغم کولو پر ځای د پروتوکول ملاتړ کوو، پدې معنی چې ستاسو د کوربه توب ادغام له بدلیدو پرته ستاسو د 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 کلي ګانو سمبالښت، د سایټونو لیدل او جوړول، د هغوی بیا پیل کول، د هغوی د کیش پاکول، او د ټکټونو لیدل او ځوابول رانغاړي. دا په قصدي توګه د بیلینګ کنټرول نه لري. په پام کې ولرئ چې د ځای پر ځای کولو (deploy) او ژوندي کولو (push-to-live) واکونه د دې برخه نه دي — که د ټیم غړی ورته اړتیا ولري، د دې پر ځای چې وګڼئ Developer خورا پراخه تخنیکي رول دی، داسې رول وټاکئ چې دا واکونه ولري.
سپارنې د بېکاف (backoff) سره بیا هڅه کوي او هره هڅه د WebhookDelivery په توګه ثبتیږي چې تاسو یې معاینه کولی شئ. په پورته جریان (upstream) کې، پېښې د بدلون په څېر د ډیټابیس په ورته معامله کې په یوه معاملواتي آوټباکس کې لیکل کیږي، نو د مصرفکوونکي د نه شتون پر مهال هېڅ شی نه ضایع کیږي — یو کار لوېدلی مصرفکوونکی یوازې ځنډیږي، دا هېڅکله تولیدونکی نه خرابوي، او کله چې تاسو بېرته راشئ نو کولی شئ له ډشبورډ څخه سپارنې بیا پیل کړئ.
د Footprint-Free کوربتوب ۱۴ ورځنۍ بې کارټه ازموینه پیل کړئ — د تادیې معلومات نشته، تر ۵ سایټونو پورې. تادیه شوي Footprint-Free کچې د PBN 5 لپاره په میاشت کې له $6 څخه پیل کیږي. هر پلان د ۳۰ ورځو د پیسو بیرته ورکولو تضمین، وړیا لیږدونه او د پلورونکي نه پابندۍ لري.
د مشخصاتو پر بنسټ API، تولید شوي SDKs، یو CLI، د Terraform چمتو کوونکی، لاسلیک شوي ویبهوکس او د MCP سرور — په هغه کوربتوب کې چې موږ په ټوله نړۍ کې د 700,000+ سایټونو لپاره جوړ کړی دی. پرته له کوم کارت او تادیاتو جزیاتو د 14 ورځو آزموینې سره پیل وکړئ.
وړیا پیل کړئدغو پلوگانونو څخه هر یو ستاسو د WordPress سایټ یو MCP سرور جوړوي، تر څو Claude، Cursor، VS Code او نور مصنوعي ځیرکتیا مرستیالان پرې ریښتینی کار وکړي، چې ستاسو په توګه ننوځي او په هغه څه پورې محدود دي چې تاسو ته یې د کولو اجازه لرئ.