د پرمختګ کونکو لپاره
Zinn Digital® یو API-لومړی پلیټ فارم دی. د همدې انجن API چې زموږ ډشبورډ چلوي، هغه څه دي چې تاسو یې تر لاسه کوئ — نسخه شوی، د ځانګړتیاوو په لومړیتوب ولاړ او د جوړولو په وخت کې ۱۰۰٪ مستند شوی، چې تولید شوي SDKs، یوه CLI، د Terraform چمتوکوونکی، لاسلیک شوي ویبهوکونه او په سر کې یې یو MCP سرور لري. هر هغه څه چې تاسو یې د کار لپاره کاروئ — یو ټرمینل، پایپلاین، د سټیټ فایل یا یو AI اېجنټ — پلیټ فارم ورته ځواب وايي.
ډېر کوربه شرکتونه وروسته بیا کنټرول پینل ته یو API ورتتوي، او دا ښکاره هم شي — د پینل نیمایي ځانګړتیاوې هېڅکله بهر نه راځي. موږ برعکس کار وکړ. ډشبورډ، د اډمین کنسول، CLI، د Terraform پرووایډر، د MCP سرور او ستاسو خپل ادغامونه ټول ورته انجن API کاروي. که تاسو دا په پینل کې کولی شئ، تاسو یې په کود کې هم کولی شئ.
د OpenAPI مشخصات د حقیقت سرچینه ده، او تر هغه وخته پورې هېڅ پای ټکی (endpoint) نه خپرېږي تر څو چې په مشخصاتو کې شامل نه وي. همدغه یوازینی قانون هغه څه دی چې عامه API د وروسته پر ځای د جوړولو په وخت کې په بشپړ ډول مستند کوي — هېڅ ناستند شوې برخه شتون نه لري، ځکه چې یو ناستند شوی پای ټکی شتون نه شي کولای.
متحرک حوالاتي سندونه، څلور پېرودونکي SDKs، د CLI ډیره برخه او د Terraform فراهم کونکي سکافولډینګ ټول د همدې یوې مشخصې څخه جوړ شوي دي. یوې سرچینې، ډیری آثار، تل په مطابقت کې — تاسو هیڅکله د داسې یو سند پسې نه یاست چې د پلي کولو څخه لرې شوی وي.
پایاسې د /v1 لاندې د یوې خپرې شوې لرغونتوب پالیسۍ او د بدلونونو ثبت (changelog) سره موقعیت لري. تاسو ته د کوم بدلون له راوستلو مخکې، په لیکلي بڼه خبر درکول کیږي، نه دا چې د ناکام جوړښت (build) له لارې پرې پوه شئ.
د پلي کولو او ځانګړتیا ترمنځ د قرارداد ازموینې او د اوپن پيآي لينټېنګ (OpenAPI linting) په هر بدلون کې اجرا کېږي. د کوډ او قرارداد ترمنځ توپیر بلډ (build) ناکاموي—نو هغه ځانګړتیا چې تاسو ترې خپل کلیینټ جوړوئ هماغه ځانګړتیا ده چې سرور يې په حقیقت کې مني.
دننه کیدو دوې لارې، خو د هغو تر شا یو متحد اصل دی. چې کومه یوه هم وکاروئ، ورته د اجازې چکونه او ورته د ډیټابیس په کچه جلا والی پلي کیږي.
کلیدونه د zdk_<mode>_<prefix>_<secret> په بڼه وي. د راز يوازې د SHA-256 هېش (hash) ساتل کېږي — موږ نشو کولای چې د صادریدو وروسته تاسو ته بیا کلید وښیو، او نه هم هغه څوک چې زموږ ډیټابیس ته لاسرسی لري. کلیدونه سکوپونه لري، لغوه کېدای شي، او د هر شخص پر ځای د هرې ادارې لپاره صادریږي.
د سېنډبکس کليوي د پروډکشن له کليوي څخه جلا دي او په سېنډبکس اډ کې کار کوي: هېڅ اصلي بلنګ نشته، هېڅ اصلي پروېژنينګ نشته. ستاسو انټيګرېشن ټسټونه کولی شي چې د پيسو له لګولو او یا سرورونو له جوړولو پرته پر API برید وکړي.
د کاروونکي ناستې د Keycloak لخوا د صادرو شویو JWTs سره تایید کیږي، چې د ریلم عامه کیلي پر وړاندې معاینه کیږي، او د همدې Principal څیز په توګه حل کیږي لکه څنګه چې د API کیلي ده. پای ټکي د دانهاي اجازې په کیلي ګانو لکه sites.create یا apikeys.manage باندې کنټرول کیږي، چې د هر سازمان لپاره په جلا توګه څارل کیږي — په یو سازمان کې اجازې په بل، بېتعلقه سازمان کې هېڅ لاسرسی نه ورکوي، که څه هم دا د هغو سازمانونو لپاره د پلي کېدو وړ دي چې د دې تر لاندې ځای پر ځای شوي دي.
د پیرودونکي هره غوښتنه په داسې یو لیږد (transaction) کې پرمخ ځي چې د پوسټګریس (Postgres) د سازمان ساحه (org scope) په کې له اصل (principal) څخه تنظیم شوې وي، نو جلاوالی د ډیټابیس لخوا پلي کیږي، نه د ORM فلټر لخوا چې ممکن څوک یې هېر کړي. د کوېري سیټ (queryset) فلټر بیا هم د ژورې دفاع په توګه شتون لري.
یو API په README کې ښه ښودل اسانه دي او د اصلي ترافیک لاندې یې ساتل ستونزمن دي. دا هغه برخې دي چې موږ پرې ډېر کار کړی، ځکه چې دا هغه برخې دي چې د سهار په دریو بجو انټيګرېشنونه ماتوي.
یو د پام وړ تفصیل، ځکه چې دا بڼه ورکوي چې څنګه په لویه کچه کار چلند کوي: د ډپلیکیټ ډومین په صورت کې 409 د هر ټریننټ لپاره "ایا دا هوسټ نوم دلته هوسټ شوی دی؟" ځوابوي، کوم چې د شمارنې اوریکل دی او د Footprint-Free په وړاندې یو ریښتینی د نوم نه پټولو خطر دی. د سایټ د جوړولو محدودول به یو اسانه حل و او د بلک پروویژنینګ محصول به یې په بشپړ ډول خراب کړی وی. پرځای یې یوازې د رد شوي ډپلیکیټ ډومین هڅو ته، د هر پرنسپل په اساس، بودیجه ورکول کیږي. بریالي جوړ شوي توکي هغومره نه لګښت کیږي - نو تاسو کولی شئ ټوله ورځ په لویه کچه پروویژن وکړئ، او پروب کول تقریبا سمدلاسه له منځه ځي.
د ورته مشخصاتو درې مصرف کونکي، د کار کولو دریو مختلفو لارو لپاره۔
د TypeScript، Python، PHP او Go لپاره جوړ شوی، چې دا مشخصات تعقیبوي ترڅو یو نوی پای ټکی (endpoint) ستاسو په ژبه کې پرته له دې چې د لاسي لیکل شوي ریپر (wrapper) په تمه پاتې شي، ورسېږي.
د یو WordPress سایټ بنسټ جوړ کړئ، هغه په ځایي توګه د Node پرته له بل څه نصبولو چل کړئ، او خپور یې کړئ. Zinnector® ستاسو پروژه د هغه ځای په وړاندې چې تاسو یې د خپرولو په حال کې یاست مخکې له مخکې معاینه کوي — د PHP نسخه، ډیسک، د فایل شمیره — او د پش کولو پرځای د هغې څخه مخکې خبرداری درکوي. دا همدا راز ننوځي، سایټونه لیست کوي، خپروي، ډومینونه او DNS اداره کوي، د بریښنالیک خدمتونه لولي، بیک اپونه اخلي، د اجازه ورکړل شوي لیست WP-CLI چلوي، لوګونه تعقیبوي او ډله ایز عملیات ترسره کوي. وړیا، د MIT جواز لاندې، او په دې ورته عامه API جوړ شوی.
سایټونه، ډومینونه، د DNS ریکارډونه، میل باکسونه او پلانونو ته د کوډ په توګه د زیربنا (infrastructure as code) په توګه مدیریت وکړئ. د terraform apply په کارولو سره کوربه توب چمتو کیږي، او ستاسو چاپیریالونه د کلیکونو د یوې نامعلومې لړۍ پر ځای چې چا نه وي لیکلي، د بیا تولید وړ او د کتلو وړ ګرځي.
تولید شوي اسناد چې تاسو یې لوستلی شئ او له براوزر څخه یې غوښتلای شئ، او هغه پای ټکي (endpoints) په دقیق ډول بیانوي چې سرور یې پلي کوي — ځکه چې دواړه د یوې مشخصې نقشې (spec) څخه راځي.
د پلیټ فارم تر شا یو پیاوړی ایونټ سپاین شتون لري: د حالت هره بدلون په پوسټګرېس کې یو معاملي آوټ باکس ته یو ایونټ لیکی، چې د ډیټابیس له بدلون سره په اټومي توګه سم دی، او یو ریلې دا NATS JetStream ته خپروي. ایونټونه ټایپ شوي او نسخه شوي دي — site.deployed، order.paid، invoice.overdue، backup.completed، abuse.flagged، trial.ending او پاتې نور.
یو پای ټکی د WebhookSubscription په توګه راجستر کړئ او د هغې د ترلاسه کیدو وړ پیښو ډولونه وټاکئ. یو سټریم خبرتیاوې، تحلیلونه، اتوماتونه او ستاسو ادغام په ورته وخت کې تغذیه کوي - تاسو دقیقا هغه ورته پیښې مصرف کوئ کوم چې موږ یې کوو.
هر تحویل په HMAC لاسلیک شوی ترڅو تاسو وکولی شئ د دې پلي کولو دمخه تصدیق کړئ چې دا له موږ څخه راغلی دی.
ناکامې لېږنې د بېلابېلو ځنډونو سره بیا هڅول کېږي او هره هڅه د WebhookDelivery په توګه ثبتېږي. تاسو کولی شئ د ملاتړ ټیم ته د برېښنالیک لیږلو او پوښتل پر ځای چې موږ څه استولي دي، له ډشبورډ څخه لېږنې وڅرئ او بیا یې ولېږئ.
پایپلاین په قصدي توګه د «لږ تر لږه یو ځل» پر بنسټ کار کوي، نه د «یوازې یو ځل» د پلمه کولو په څیر. هغه ریلې چې د خپرولو په جریان کې له منځه ځي، د هغې د ادعا اجاره پای ته رسېږي او پیښې یې بیا خپرېږي. د انولپ په آی ډي (ID) بې ځایه کېدنه لرې کړئ او ستاسو مصرف کوونکی به د جوړښت له مخې سم وي.
د API یوه برخه د پرمختګ کونکي کیسه ده، او بله برخه یې خپرول دي.
موږ دا پلیټ فارم د کوربه شوي MCP سرور په توګه وړاندې کوو: د انجن API په سر کې یو نری پروتوکول اډاپټر چې ورته عمل کتلاګ، RBAC او د تفتیش لاره بیا کاروي. کلود کوډ، کورسر، چیټ جیپيټي، کلود ډیسکټوپ یا کوم بل د MCP وړ پیرودونکي یو ځل وصل کړئ، او هره هغه وړتیا چې موږ یې API ته اضافه کوو په اتوماتيک ډول ورته د لاسرسي وړ ګرځي.
استازي درې شیان ترلاسه کوي: وسایل (ورته د API پای ټکي، د پاتې کېدو لپاره کوم موازي منطق شتون نلري)، سرچینې (د سایټ لوستلو لپاره یواځې روغتیا، تشکیلات، وروستي لاګونه، میټریکونه، اپ ټایم او د KB مقننه مقالې، نو دا د عمل کولو دمخه د اصلي معلوماتو سره تشخیص کوي) او پرامپټونه (خپاره شوي کاري جریانونو قالبونه لکه "دا سایټ تشخیص کړئ" یا "د مهاجرت چمتو کول").
خوندیتوب هم د تایید په څیر دی: OAuth 2.1، ستاسو له ادارې سره تړلي ټوکنونه او د قطار په کچه د پلي شوي امنیت سره د RBAC اجازې، د هرې وسیلې لپاره په نښه شوي او د لغوه کیدو وړ، په سندبوکس کې د تولید څخه جلا شوي. ویجاړونکي کړنې - حذف کول، ځنډول، بلینګ، لوی لګښت - څرګند تایید یا د انسان لخوا د تصویب پالیسۍ ته اړتیا لري. د نرخ حدونه او د لګښت حدونه د AI لخوا رامینځته شوي تادیه شوي کړنې محدودوي، او د MCP هره غوښتنه د هویت، وسیلې، استدلالونو او پایلې سره د تفتیش لاګ کیږي.
موږ د هرې اپلیکیشن د یو په بل پسې د یوځای کولو پرځای د پروتوکول ملاتړ کوو، پدې معنی چې ستاسو د مصنوعي ځیرکتیا (AI) د وسیلو انتخاب بدلېدی شي پرته لدې چې ستاسو د کوربه توب ادغام ورسره بدل شي.
هو - دا همدغه د انجن API دی، چې خپور او پیاوړی شوی دی. ډشبورډ، د مدیر کنسول، CLI، د ټرافورم چمتو کونکی، د MCP سرور او ویب هکونه ټول د یوې سطحې مصرف کونکي دي، له همدې امله API د پینل وروسته پاتې نه کیږي.
هو. د سېنډباکس کليالې د پروډکشن له کليالو څخه په جلا توګه صادرېږي او په ټېسټ حالت کې کار کوي: حقیقي بلینګ او حقیقي چمتووالی پکې نشته. خپل CI د سېنډباکس پر اعتبارلیکونو وټاکئ او د غوښتنې او ځواب بشپړ پړاو په خوندي توګه و ازموئ.
خپله POST غوښتنه کې یو Idempotency-Key واستوئ. د بیا غوښتنې ریکارډ د انلاین پر ځای د ثبت (commit) پر مهال لیکل کېږي، نو بیا هڅه (retry) هېڅکله نشي کولای د هغې قطار لپاره چې په حقیقت کې نه وي ثبت شوی، یو کیش شوی بریالیتوب بیا غږ کړي، او ناکامه شوې غوښتنه خپل لاک سمدلاسه خوشې کوي ترڅو ستاسو سمه شوې بیا هڅه ځنډنۍ نه شي. د ویبهوک رسول د ډیزاین له مخې لږ تر لږه یو ځل دی — په خپل اړخ کې د لفافې ID (envelope id) پر بنسټ تکرار له منځه یوسي.
نن نه. د API کیلي د هر سازمان لپاره جلا صادرېږي، نو هغه انټيګرېشن چې څو د پیرودونکي سازمانونه تر پوښښ لاندې نیسي، د هر یو لپاره جلا کیلي لري. د کاروونکو د اصلي حسابونو لپاره اجازه لیکونه هم د هر سازمان په کچه چک کېږي: په یو سازمان کې د sites.create لرل په بل, بېتلاقه سازمان کې هېڅ لاسرسی نه ورکوي، که څه هم دا د هغو سازمانونو په اړه تطبیقېږي چې د هغې تر پوښښ لاندې دي. دا په قصدي توګه دی — دا یو خطر سره مخ شوې کیلي یوازې په خپل سازمان او د هغې لاندې فرعي سازمانونو پورې محدودوي، نه ټول پلاتفورم ته.
د پرالټو رول د سازمان لوستل، د API کلي مدیریت، د سایټونو لیدل او جوړول، د هغوی بیا پیلول، د هغوی د کیش پاکول، او ټکټونو ته لیدل او ځواب ورکول پوښي. دا په قصدي توګه د بلینګ کنټرول نه لري. په پام کې ونیسئ چې د ډپلای او پش ټو لایو اجازې د دې برخه نه دي — که یو ټیم غړی ورته اړتیا ولري، یو داسې رول ورکړئ چې هغه ولري پرځای د دې چې دا وگڼئ چې پراختیا کونکی تر ټولو پراخ تخنیکي رول دی.
تحویلونه د شا تګ (backoff) په مرسته بیا هڅول کیږي او هره هڅه د یو WebhookDelivery په توګه ثبت کیږي کوم چې تاسو یې لیدلی شئ. د سرچینې په لور، پیښې د بدلون سره په ورته ډیټابیس ټرانزاکشن کې د ټرانزاکشنل آؤټ باکس (transactional outbox) ته لیکل کیږي، نو کله چې کوم مصرف کونکی (consumer) شتون ونلري هیڅ شی نه له لاسه ځي — یو غیر فعال مصرف کونکی شاته پاتې کیږي، دا هېڅکله تولید کونکی نه خرابوي، او تاسو کولی شئ چې د بیرته راتلو وروسته د ډشبورډ څخه تحویلونه بیا وپلورئ.
د Footprint-Free Hosting په یو کارت څخه پاک ۱۴ ورځني ازمویښت پیل کړئ — د تادیې کومو معلوماتو ته اړتیا نشته، تر ۵ سایټونو پورې. د Footprint-Free تادیه شوي کچې د PBN 5 لپاره په میاشت کې د $6 څخه پیل کیږي. هر پلان د ۳۰ ورځو لپاره د پیسو بیرته ورکولو تضمین، وړیا لیږدونه او د پلورونکي لخوا د بندولو نشتوالی لري.
لومړی مشخص شوی API، تولید شوي SDKs، یوه CLI، د Terraform چمتوکوونکی، لاسلیک شوي ویب هوکس او د MCP سرور — زموږ په هغه کورستۍ کې چې په ټوله نړۍ کې د ۶۵۰,۰۰۰+ سایټونو لپاره جوړه شوې ده. د ۱۴ ورځو په وړیا ازموینه کې پیل وکړئ، د تادیې کومو معلوماتو ته اړتیا نشته.
وړیا پیل کړئ