برای توسعهدهندگان
Zinn Digital® یک پلتفرم API-first است. همان API موتوری که داشبورد ما را پشتیبانی میکند، همان چیزی است که دریافت میکنید؛ نسخهبندیشده، spec-first و ۱۰۰٪ مستندشده در زمان ساخت، همراه با SDKهای تولیدشده، یک CLI، یک پرووایدر Terraform، وبهوکهای امضاشده و یک سرور MCP در بالای آن. هر ابزاری که برای کار استفاده میکنید — یک ترمینال، یک پایپلاین، یک فایل وضعیت یا یک عامل هوش مصنوعی — پلتفرم به آن پاسخ میدهد.
بیشتر میزبانها بعد از راهاندازی، یک API به کنترلپنل الصاق میکنند و عیب آن هم نمایان میشود؛ نیمی از قابلیتهای پنل هرگز عرضه نمیشوند. ما برعکس عمل کردیم. داشبورد، کنسول مدیریت، خط فرمان (CLI)، ارائهدهنده Terraform، سرور MCP و یکپارچهسازیهای شخصی شما همگی از یک موتور API مشترک استفاده میکنند. اگر کاری از طریق پنل امکانپذیر باشد، با کدنویسی هم قابل انجام است.
مشخصات OpenAPI منبع اصلی حقیقت است و هیچ نقطه پایانی (endpoint) منتشر نمیشود مگر اینکه در این مشخصات موجود باشد. همین یک قانون است که باعث میشود API عمومی بهجای اینکه در نهایت مستند شود، در زمان ساخت بهطور کامل مستند باشد؛ هیچ گوشه نامستوندی وجود ندارد، زیرا یک نقطه پایانی نامستند نمیتواند وجود داشته باشد.
اسناد مرجع تعاملی، چهار SDK کلاینت، بخش بزرگی از CLI و ساختار ارائهدهنده Terraform همگی از همان مشخصات تولید میشوند. یک منبع، چندین خروجی، همیشه همگام — شما هرگز به دنبال سند دور افتاده از پیادهسازی نخواهید بود.
نقطههای پایانی تحت /v1 همراه با یک سیاست منسوخسازی منتشرشده و سیاهه تغییرات فعالیت میکنند. پیش از ایجاد هرگونه تغییر، بهصورت کتبی به شما اطلاع داده میشود، نه اینکه آن را از طریق یک ساخت ناموفق کشف کنید.
آزمونهای قرارداد پیادهسازی در برابر مشخصات و لرزشسنجی (لینت) OpenAPI روی هر تغییر اجرا میشوند. انحراف بین کد و قرارداد باعث شکست بیلد میشود — بنابراین مشخصاتی که کلاینت خود را از آن تولید میکنید، همان مشخصاتی است که سرور واقعاً به آن پایبند است.
دو راه برای ورود، اما یک اصل یکسان در پسِ آنها. از هرکدام که استفاده کنید، همان بررسیهای دسترسی و همان جداسازی در سطح پایگاه داده اعمال میشود.
کلیدها به شکل zdk_<mode>_<prefix>_<secret> هستند. فقط یک هش SHA-256 از راز ذخیره میشود — ما نمیتوانیم پس از صدور، دوباره کلیدی را به شما نشان دهیم و کسی هم که به پایگاه داده ما دسترسی پیدا کند، قادر به این کار نخواهد بود. کلیدها دارا دامنههای دسترسی هستند، میتوانند لغو شوند و به ازای هر سازمان و نه هر شخص صادر میشوند.
کلیدهای سندباکس از کلیدهای پروداکشن جدا هستند و در حالت سندباکس اجرا میشوند: بدون صورتحساب واقعی، بدون پروویژنینگ واقعی. تستهای یکپارچهسازی شما میتوانند بدون صرف هزینه یا ساخت سرور، API را بمباران کنند.
نشستهای کاربر با JWTهای صادرشده توسط Keycloak احراز هویت میشوند، در برابر کلید عمومی قلمرو (realm) تأیید میگردند و به همان شیء Principal تبدیل میشوند که یک کلید API آن را انجام میدهد. پایانیهها بر اساس کلیدهای دسترسی جزئی مانند sites.create یا apikeys.manage محدود میشوند که برای هر سازمان بررسی میگردند — یک مجوز در یک سازمان هیچ دسترسی به سازمان مجزا و بیربط دیگری نمیدهد، هرچند که برای سازمانهای تو در تو در زیر آن اعمال میشود.
هر درخواست مستأجر در یک تراکنش اجرا میشود که محدوده سازمانی Postgres آن از روی پرینسیپال تنظیم شده است، بنابراین جداسازی توسط پایگاهداده اعمال میشود، نه توسط فیلتر ORM که ممکن است کسی فراموش کند. فیلتر queryset همچنان به عنوان دفاع در عمق وجود دارد.
ساختن یک API که در یک فایل README زیبا به نظر برسد آسان است، اما دشوار است که در برابر ترافیک واقعی به درستی عمل کند. اینها همان بخشهایی هستند که ما برایشان زحمت کشیدیم، زیرا همان بخشهایی هستند که در ساعت سه بامداد یکپارچهسازیها را خراب میکنند.
یک نکته قابل ذکر، از آنجا که نحوه عملکرد کار گروهی را شکل میدهد: پاسخ خطای 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 ثبت میشود. به جای ایمیل زدن به پشتیبانی و پرسیدن اینکه چه چیزی فرستادهایم، میتوانید تحویلها را از داشبورد بررسی و دوباره پخش کنید.
این پایپلاین عمدتاً بهصورت «حداقل یکبار» (at-least-once) طراحی شده است تا اینکه بخواهد بهدرستی وانمود کند «دقیقاً یکبار» (exactly-once) است. ریلایی که در حین انتشار از کار بیفتد، اجارهٔ ادعای آن منقضی شده و رویدادهایش مجدداً منتشر میشوند. با حذف موارد تکراری روی شناسهٔ پاکت (envelope id)، مصرفکنندهٔ شما بهطور ساختاری درست عمل میکند.
یک API تنها نیمی از داستان یک توسعهدهنده است. نیم دیگر انتشار است.
API یک در است. اینها چهار در دیگر هستند و هر یک از آنها به جای اینکه به عنوان یک سطح توسعهدهنده فروخته شوند، در پلن گنجانده شدهاند.
VS Code در مرورگر، باز شده از صفحه سایت در داشبورد، با ویرایش فایلهای واقعی همان سایت بهصورت داخلی با git و کل ویرایشگر درون همان CageFS jail مشابه دسترسی SFTP شما. این ابزار سایت LIVE را ویرایش میکند — هیچ نسخه مرحلهبندی (staging) در میان نیست، بنابراین فایلی که ذخیره میکنید در همان لحظه که نوشته میشود عمومی خواهد بود.
رایگان، دارای مجوز MIT و ساخته شده بر روی همین API عمومی. یک سایت WordPress بسازید، آن را روی رایانه خود اجرا کنید، آن را در برابر اسلاتی که میخواهید مستقر کنید بررسی کنید — نسخه PHP، دیسک، تعداد فایلها — و مستقر کنید. به Node 24 یا جدیدتر نیاز دارد.
یک فهرست جامع از ابزارها، به طوری که کلاینت هوش مصنوعی که در حال حاضر استفاده میکنید میتواند از طریق همان API و همان دسترسیهایی که داشبورد استفاده میکند، روی سایتهای شما کار کند. همان سروری که کلاینت خودتان به آن متصل میشود، همان سروری است که به ویرایشگر وب متصل شده است. تا زمانی که خودتان اجازه ندادهاید، فقطخواندنی باقی میماند.
کار مشتری به رمز عبور شما نیاز ندارد. کسی را با آدرس ایمیل دعوت کنید و او دقیقاً یک سایت دریافت میکند: با حساب خودش و با نقش مشاهدهگر، ویرایشگر یا مدیر وارد میشود و هر سایت دیگری پیش از اجرای هر کنترلکنندهای خطای 404 برمیگرداند — یک سیاست امنیت در سطح رقر پُستگرس (Postgres) و یک حصار در سطح درخواست، نه فقط یک بررسی ساده. مالک حساب با یک کلیک دسترسی را اعطا و لغو میکند که در درخواست بعدی آنها اعمال میشود.
ما این پلتفرم را به عنوان یک سرور MCP میزبانیشده ارائه میدهیم: یک آداپتور پروتکل سبک روی API موتور که کاتالوگ اکشنهای یکسان، RBAC و مسیر حسابرسی را مجدداً استفاده میکند. Claude Code، Cursor، ChatGPT، Claude Desktop یا هر کلاینت سازگار با MCP را یک بار متصل کنید، و هر قابلیت جدیدی که به API اضافه کنیم، بهطور خودکار در آن در دسترس قرار میگیرد.
ایجنت سه چیز دریافت میکند: ابزارها (همان نقاط پایانی API، بدون منطق موازی برای انحراف)، منابع (سلامت سایت فقط خواندنی، پیکربندی، گزارشهای اخیر، معیارها، زمان آپدیت و مقالات پایگاه دانش، بهطوریکه پیش از اقدام با دادههای واقعی عیبیابی میکند) و پرامپتها (قالبهای گردش کار منتشرشده مانند «عیبیابی این سایت» یا «آمادهسازی یک مهاجرت»).
امنیت همان داستان احراز هویت است: OAuth 2.1، توکنهای متصل به سازمان شما و دسترسیهای RBAC همراه با اعمال امنیت در سطح رسطر، محدود و قابل لغو برای هر ابزار، سندباکس جدا شده از محیط تولید. اقدامات تخریبی — حذف، تعلیق، صورتحساب، هزینههای بالا — نیازمند تأیید صریح یا خطمشی تأیید انسانی هستند. محدودیتهای نرخ و سقف هزینهها، اقدامات پولی را که توسط هوش مصنوعی راهاندازی میشوند کنترل میکنند و هر فراخوانی MCP همراه با هویت، ابزار، آرگومانها و نتیجه، ثبت حسابرسی (audit-logged) میشود.
ما به جای یکپارچهسازی تکتک برنامهها، از پروتکل پشتیبانی میکنیم؛ این یعنی ابزارهای هوش مصنوعی انتخابی شما میتوانند بدون نیاز به تغییر در یکپارچهسازی میزبانیتان، تغییر کنند.
بله — این همان API موتور است، منتشرشده و مقاومسازیشده. داشبورد، کنسول مدیریت، CLI، ارائهدهنده Terraform، سرور MCP و وبهوکها همگی مصرفکننده یک رابط هستند، و به همین دلیل است که API از پنل عقب نمیماند.
بله. کلیدهای سندباکس جدا از کلیدهای پروداکشن صادر میشوند و در حالت تست اجرا میشوند: بدون صورتحساب واقعی و بدون پروویژنینگ واقعی. CI خود را به سمت اعتبارنامههای سندباکس نشانه بروید و چرخه کامل درخواست و پاسخ را با خیال راحت آزمایش کنید.
یک کلید عدمتأثیر (Idempotency-Key) در درخواست POST خود ارسال کنید. رکورد بازپخش بهجای ثبت درونخطی (inline)، در هنگام کامیت نوشته میشود؛ بنابراین یک تلاش مجدد هرگز نمیتواند موفقیت کششده را برای سطری که در واقعیت کامیت نشده است بازپخش کند، و درخواستی که با خطا مواجه شود قفل خود را بلافاصله آزاد میکند تا تلاش مجدد اصلاحشدهی شما معطل نماند. تحویل وبهوک طبق طراحی از نوع حداقل-یکبار (at-least-once) است — در سمت خود بر اساس شناسه پاکت (envelope id) جلوی تکرار را بگیرید.
امروز نه. کلیدهای API برای هر سازمان صادر میشوند، بنابراین یک ادغام که چندین سازمان مشتری را در بر میگیرد، یک کلید برای هر کدام دارد. مجوزها نیز برای مدیران کاربر به ازای هر سازمان بررسی میشوند: داشتن sites.create در یک سازمان هیچ دسترسیای در یک سازمان جداگانه و نامربوط اعطا نمیکند، اگرچه برای سازمانهای تو در تو در زیر آن اعمال میشود. این یک امر عمدی است — کلید در معرض خطر را به سازمان خودش و زیرسازمانهای زیر آن محدود میکند، نه کل پلتفرم را.
نقش توسعهدهنده شامل خواندن سازمان، مدیریت کلید API، مشاهده و ایجاد سایتها، راهاندازی مجدد آنها، پاکسازی کش آنها، و مشاهده و پاسخ به تیکتها میشود. این نقش بهطور عمدی کنترل صورتحساب را مستثنی میکند. توجه داشته باشید که مجوزهای استقرار (deploy) و ارسال به حالت زنده (push-to-live) جزء آن نیستند — اگر یکی از اعضای تیم به آنها نیاز دارد، نقشی را اختصاص دهید که شامل آنها باشد، نه اینکه فرض کنید نقش توسعهدهنده گستردهترین نقش فنی است.
تحویلها با روش پسافت مجدداً تلاش میشوند و هر کوشش به عنوان یک WebhookDelivery ثبت میشود که میتوانید آن را بررسی کنید. در سمت بالادست، رویدادها در یک جدول خروجی تراکنشی طی همان تراکنش پایگاه دادهایِ خود تغییر نوشته میشوند، بنابراین زمانی که یک مصرفکننده در دسترس نیست هیچچیزی از دست نمیرود — یک مصرفکننده ازکارافتاده عقب میافتد اما هرگز تولیدکننده را مختل نمیکند، و پس از بازگشت میتوانید تحویلها را از داشبورد دوباره پخش کنید.
آزمایش ۱۴ روزه رایگان و بدون نیاز به کارت بانکی هاستینگ Footprint-Free را شروع کنید؛ بدون نیاز به اطلاعات پرداخت و برای حداکثر ۵ سایت. پلنهای پولی Footprint-Free از ۶ دلار در ماه برای PBN 5 آغاز میشوند. همه پلنها دارای ۳۰ روز ضمانت بازگشت وجه، مهاجرت رایگان و بدون قفل شدن در انحصار فروشنده هستند.
API مبتنی بر مشخصات، SDKهای تولیدشده، یک رابط خط فرمان (CLI)، یک ارائهدهنده Terraform، وبهوکهای امضا شده و یک سرور MCP — روی هاستینگی که برای بیش از ۶۵۰,۰۰۰ سایت در سراسر جهان ساختهایم. آزمایش ۱۴ روزه بدون نیاز به کارت اعتباری و جزئیات پرداخت را آغاز کنید.
شروع رایگان