للمطورين
تُعد Zinn Digital® منصة تعتمد على واجهة برمجة التطبيقات أولاً (API-first). واجهة برمجة تطبيقات المحرك ذاتها التي تشغل لوحة التحكم الخاصة بنا هي نفسها التي تحصلون عليها — ذات إصدارات محددة، ومبنية على المواصفات أولاً، وموثقة بنسبة 100% وقت الإنشاء، مع حزم SDK منشأة تلقائيًا، وواجهة سطر أوامر (CLI)، ومزود Terraform، وخطافات ويب (webhooks) موقعة، وخادم MCP إضافي فوق ذلك. أيًا كان ما تستخدمونه للعمل — سواء كان موجه أوامر، أو مسار معالجة، أو ملف حالة، أو وكيل ذكاء اصطناعي — فإن المنصة تستجيب له.
تكتفي معظم شركات الاستضافة بإضافة واجهة برمجة تطبيقات (API) إلى لوحة التحكم كفكرة لاحقة، وهذا واضح للعيان — فنصف ميزات اللوحة لا تصل إليها أبدًا. لقد بنينا نظامنا بالاتجاه المعاكس تمامًا. لوحة التحكم، ووحدة تحكم المشرف، وواجهة سطر الأوامر (CLI)، ومزود Terraform، وخادم MCP، وتكاملاتكم الخاصة، جميعها تستهلك واجهة برمجة التطبيقات الأساسية للمحرك نفسه. إن كان بإمكانكم تنفيذه في اللوحة، فيمكنكم تنفيذه عبر البرمجة.
تُعد مواصفة OpenAPI هي المصدر الموثوق للحقيقة، ولا يتم إطلاق أي نقطة نهاية ما لم تكن مدرجة في المواصفة. هذه القاعدة الفردية هي ما يجعل واجهة برمجة التطبيقات العامة موثقة بالكامل في وقت البناء بدلاً من توثيقها لاحقاً — فليس هناك أي جانب غير موثق، لأنه لا يمكن لنقطة نهاية غير موثقة أن توجد أصلاً.
تُنشأ وثائق المرجع التفاعلية، ومجموعات تطوير البرمجيات الأربعة للعميل، وجزء كبير من واجهة سطر الأوامر (CLI)، وهيكل موفر Terraform كلها من تلك المواصفة الواحدة. مصدر واحد، ومنتجات متعددة، ومزامنة دائمة — لن تضطروا أبداً إلى تتبع مستند حاد عن التنفيذ الفعلي.
توجد نقاط النهاية تحت المسار /v1 مع سياسة إيقاف تشغيل منشورة وسجل للتغييرات. يتم إخطاركم كتابيًا قبل حدوث أي تغيير، بدلاً من اكتشافه من خلال فشل عملية البناء.
يتم تشغيل اختبارات مطابقة التنفيذ للمواصفات وفحص OpenAPI مع كل تغيير. يؤدي أي تباين بين الرمز البرمجي والعقد إلى فشل عملية البناء — وبذلك تكون المواصفة التي تنشئ عميلك منها هي ذاتها التي يلتزم بها الخادم فعلياً.
طريقتان للدخول، وراءهما مبدأ موحد واحد. أيًّا كانت الطريقة التي تستخدمونها، يتم تطبيق عمليات التحقق من الأذونات نفسها ومستوى العزل نفسه على قاعدة البيانات.
تبدو المفاتيح مثل zdk_<mode>_<prefix>_<secret>. يتم تخزين تجزئة SHA-256 للسر فقط — لا يمكننا إظهار المفتاح لك مرة أخرى بعد إصداره، ولا يمكن لأي شخص يصل إلى قاعدة بياناتنا فعل ذلك أيضاً. تحمل المفاتيح نطاقات، ويمكن إبطالها، ويتم إصدارها لكل مؤسسة بدلاً من كل شخص.
مفاتيح بيئة الاختبار (Sandbox) منفصلة عن مفاتيح بيئة الإنتاج وتعمل وفق وضع بيئة الاختبار: لا توجد فوترة فعلية، ولا تجهيز فعلي للخوادم. يمكن لاختبارات التكامل الخاصة بكم إرسال طلبات مكثفة إلى واجهة برمجة التطبيقات (API) دون إنفاق أموال أو إنشاء خوادم.
تتم مصادقة جلسات المستخدم باستخدام رموز JWT الصادرة عن Keycloak، والتي يتم التحقق منها عبر المفتاح العام للنطاق، وتؤول إلى نفس كائن Principal الذي يؤول إليه مفتاح API. وتعتمد نقاط النهاية على مفاتيح أذونات دقيقة مثل sites.create أو apikeys.manage، ويتم فحصها لكل مؤسسة على حدة — حيث لا يمنح الإذن في مؤسسة معينة أي وصول في مؤسسة أخرى منفصلة وغير مرتبطة، على الرغم من أنه ينطبق على المؤسسات المتفرعة منها.
يتم تشغيل كل طلب مستأجر في معاملة مع تعيين نطاق مؤسسة Postgres من الأصل، وبالتالي يتم فرض العزل بواسطة قاعدة البيانات، وليس بواسطة مرشح ORM قد ينساه شخص ما. لا يزال مرشح queryset موجودًا كدفاع متعمق.
من السهل جعل واجهة برمجة التطبيقات (API) تبدو جيدة في ملف README، ولكن من الصعب جعلها تعمل بكفاءة تحت ضغط الاستخدام الفعلي. هذه هي الأجزاء التي بذلنا فيها قصارى جهدنا، لأنها الأجزاء التي قد تتسبب في تعطل عمليات التكامل عند الثالثة فجرًا.
تفصيل واحد يستحق الذكر، لأنه يحدد كيفية عمل العمليات المجمعة: ظهور خطأ 409 عند تكرار النطاق يجيب على "هل اسم المضيف هذا مستضاف هنا؟" لأي مستأجر، وهو ما يُعد وسيلة تعداد استكشافية (enumeration oracle) وخطرًا حقيقيًا لكشف الهوية ضد Footprint-Free. كان خنق (throttling) إنشاء المواقع سيكون هو الحل السهل ولكنه كان سيعطل منتج الإعداد المجمع تمامًا. بدلاً من ذلك، يتم احتساب المحاولات المرفوضة للنطاقات المكررة فقط ضمن الميزانية، لكل مستخدم رئيسي. عمليات الإنشاء الناجحة لا تُحتسب أبدًا ضده — لذا يمكنكم الإعداد بكميات كبيرة طوال اليوم، بينما تتوقف عمليات الاستكشاف فورًا تقريبًا.
ثلاثة مستهلكين لنفس المواصفة، لثلاث طرق عمل مختلفة.
تم إنشاؤه لـ TypeScript وPython وPHP وGo، مع تتبع المواصفات بحيث تصل نقطة النهاية الجديدة إلى لغتكم دون انتظار غلاف مكتوب يدويًا.
أنشئ بنية موقع WordPress، وشغّله محلياً دون تثبيت أي شيء سوى Node، وانشره. يتحقق Zinnector® مسبقاً من مشروعكم مقارنة بالفتحة التي توشكون على النشر إليها — إصدار PHP، والقرص، وعدد الملفات — ويحذركم قبل الرفع بدلاً من بعده. كما يسجّل الدخول، ويعرض المواقع، وينشر، ويدير النطاقات وDNS، ويقرأ خدمات البريد، ويأخذ نسخاً احتياطية، ويشغّل أوامر WP-CLI المدرجة في القائمة المسموح بها، ويتتبع السجلات مباشرة، وينفذ العمليات المجمعة. مجاني، ومرخص بموجب ترخيص MIT، ومبني على واجهة برمجة التطبيقات العامة هذه ذاتها.
قم بإدارة المواقع والنطاقات وسجلات DNS وصناديق البريد والخطط بصفتها بنية تحتية كتعريف برمجى (IaC). يقوم الأمر terraform apply بتهيئة الاستضافة، وتصبح بيئاتكم قابلة لإعادة الإنتاج والمراجعة بدلاً من كونها مجرد سلسلة من النقرات التي لم يوثقها أحد.
مستندات تم إنشاؤها يمكنك قراءتها واستدعاؤها من المتصفح، تصف بدقة نقاط النهاية التي ينفذها الخادم — لأن كلاهما يأتي من نفس المواصفات.
يقف وراء المنصة عمود فقري متين للأحداث: يكتب كل تغيير في الحالة حدثاً إلى صندوق صادر للمعاملات في Postgres بشكل ذري بالتزامن مع تغيير قاعدة البيانات، ثم ينشره مُرحِّل إلى NATS JetStream. الأحداث محددة الأنواع والإصدارات — site.deployed، وorder.paid، وinvoice.overdue، وbackup.completed، وabuse.flagged، وtrial.ending وباقي الأحداث.
سجّل نقطة نهاية كـ WebhookSubscription واختر أنواع الأحداث التي تتلقاها. دفق واحد يغذي الإشعارات والتحليلات وعمليات التنفيذ الآلي والتكامل الخاص بك على حد سواء — فأنت تستهلك نفس الأحداث التي نستهلكها نحن.
كل عملية تسليم موقعة برمز HMAC حتى تتمكنوا من التحقق من أنها صادرة منا قبل اتخاذ أي إجراء بشأنها.
تتم إعادة محاولة عمليات التسليم الفاشلة مع تراجع زمني تدريجي، ويتم تسجيل كل محاولة كـ WebhookDelivery. يمكنك فحص عمليات التسليم وإعادة تشغيلها من لوحة التحكم بدلاً من مراسلة الدعم عبر البريد الإلكتروني للاستفسار عما أرسلناه.
يعمل خط الأنابيب عن قصد بنظام «مرة واحدة على الأقل» بدلاً من التظاهر بأنه بنظام «مرة واحدة بالضبط». فالمرحّل الذي يتعطل في منتصف عملية النشر تنتهي صلاحية عقد المطالبة الخاص به ويُعاد نشر أحداثه. تخلّص من التكرار بناءً على معرّف المغلّف وسيصبح المستهلك لديكم صحيحاً تصميماً وبناءً.
واجهة برمجة التطبيقات ليست سوى نصف قصة المطور. والنصف الآخر هو الإطلاق.
تُعد واجهة برمجة التطبيقات بابًا واحدًا. هذه هي الأبواب الأربعة الأخرى، وكل واحد منها مشمول في الخطة بدلاً من بيعه كفئة منفصلة للمطورين.
برنامج VS Code في المتصفح، مفتوح من صفحة الموقع في لوحة التحكم، ويقوم بتحرير الملفات الفعلية لذلك الموقع مع git مدمج ومحرر كامل داخل نفس سجن CageFS الخاص بوصول SFTP الخاص بكم. إنه يحرر الموقع الحي مباشرة (LIVE) — لا توجد نسخة مرحلية وسيطة، وبالتالي فإن الملف الذي تحفظونه يصبح متاحًا للعامة فور كتابته، على الرغم من أن الملف الثابت قد يستمر في العرض من ذاكرة التخزين المؤقت لـ CDN لمدة تصل إلى أربع ساعات.
مجاني، ومرخص بموجب MIT ومبني على واجهة برمجة التطبيقات العامة نفسها. قم بإنشاء هيكل موقع WordPress، وشغّله على جهازك الخاص، وأجرِ فحصاً أولياً لمطابقته مع المنفذ الذي توشك على النشر فيه — إصدار PHP ومساحة القرص وعدد الملفات — ثم انشر. يتطلب Node 24 أو إصداراً أحدث.
دليل موحد للأدوات، لكي يتمكن عميل الذكاء الاصطناعي الذي تستخدمه بالفعل من العمل على مواقعك عبر واجهة برمجة التطبيقات ذاتها والصلاحيات ذاتها التي تستخدمها لوحة التحكم. الخادم ذاته الذي يتصل به عميلك هو نفسه المتصل بمحرر الويب. للقراءة فقط حتى تحدد خلاف ذلك.
لا يتطلب عمل العميل كلمة المرور الخاصة بكم. ادعوا شخصاً عبر عنوان البريد الإلكتروني وسيحصل على موقع واحد بالضبط: يقوم بتسجيل الدخول بهويته الخاصة، وبدور عارض أو محرر أو مدير، ويستجيب أي موقع آخر برمز 404 قبل تشغيل أي معالج — سياسة أمان على مستوى الصف في Postgres وحاجز على مستوى الطلب، وليس مجرد فحص واحد. يمنحها مالك الحساب ويلغيها بنقرة واحدة، وتصبح سارية عند طلبهم التالي.
نقدم المنصة كخادم MCP مستضاف: محول بروتوكول خفيف فوق واجهة برمجة تطبيقات المحرك، يعيد استخدام كتالوج الإجراءات نفسه، ونظام التحكم في الوصول القائم على الأدوار (RBAC)، وسجل التدقيق. قم بربط Claude Code أو Cursor أو ChatGPT أو Claude Desktop أو أي عميل يدعم MCP مرة واحدة، وستصبح كل إمكانية نضيفها إلى واجهة برمجة التطبيقات متاحة له تلقائيًا.
يحصل الوكيل على ثلاثة أشياء: الأدوات (نفس نقاط نهاية واجهة برمجة التطبيقات، دون منطق موازٍ قد ينحرف)، والموارد (حالة الموقع للقراءة فقط، والتكوين، والسجلات الأخيرة، والمقاييس، ووقت التشغيل، ومقالات قاعدة المعرفة، حتى يقوم بالتشخيص ببيانات حقيقية قبل اتخاذ أي إجراء)، والمطالبات (قوالب سير عمل منشورة مثل «تشخيص هذا الموقع» أو «التحضير للترحيل»).
الأمان هو القصة ذاتها كما في المصادقة: OAuth 2.1، ورموز مميزة مرتبطة بمؤسستكم وأذونات RBAC مع فرض أمان على مستوى الصف، ومحددة النطاق وقابلة للإلغاء لكل أداة، مع بيئة اختبار معزولة عن بيئة الإنتاج. الإجراءات التدميرية — الحذف، والتعليق، والفوترة، والإنفاق الكبير — تتطلب تأكيدًا صريحًا أو سياسة موافقة بشرية. تفرض حدود المعدل والحدود القصوى للإنفاق قيودًا على الإجراءات المدفوعة التي يتم تشغيلها بواسطة الذكاء الاصطناعي، ويتم تسجيل كل استدعاء لـ MCP في سجل التدقيق متضمنًا الهوية، والأداة، والوسائط، والنتيجة.
نحن ندعم البروتوكول بدلاً من دمج كل تطبيق على حدة، مما يعني أن اختياركم لأدوات الذكاء الاصطناعي يمكن أن يتغير دون أن يتغير معه تكامل الاستضافة الخاص بكم.
نعم — إنها نفس واجهة برمجة تطبيقات (API) المحرك، منشورة ومحصنة. لوحة التحكم، ووحدة تحكم المشرف، وCLI، ومزود Terraform، وخادم MCP، وwebhooks كلها مستهلكة لواجهة واحدة، ولهذا السبب لا تتأخر واجهة برمجة التطبيقات عن اللوحة.
نعم. يتم إصدار مفاتيح Sandbox بشكل منفصل عن مفاتيح الإنتاج وتعمل في وضع الاختبار: لا توجد فواتير حقيقية ولا يتم تزويد فعلي بالخدمات. وجّهوا نظام التكامل المستمر (CI) الخاص بكم إلى بيانات اعتماد sandbox وقوموا بتشغيل دورة الطلب والاستجابة الكاملة بأمان.
أرسل Idempotency-Key في طلب POST الخاص بك. يتم تسجيل سجل إعادة التشغيل عند التثبيت (commit) وليس بشكل مضمن، لذلك لا يمكن لمحاولة إعادة أن تعيد تشغيل نجاح تم تخزينه مؤقتًا لصف لم يتم تثبيته بالفعل، كما أن الطلب الذي يفشل يحرر قفله على الفور حتى لا تتعطل محاولة الإعادة المصححة الخاصة بك. تم تصميم تسليم Webhook ليكون مرة واحدة على الأقل (at-least-once) — يرجى إلغاء التكرار استنادًا إلى envelope id من جانبك.
ليس اليوم. يتم إصدار مفاتيح API لكل مؤسسة، لذا فإن التكامل الذي يشمل عدة مؤسسات عميلة يحتفظ بمفتاح لكل منها. يتم التحقق من الأذونات أيضًا لكل مؤسسة بالنسبة للجهات الفاعلة من المستخدمين: امتلاك sites.create في مؤسسة واحدة لا يمنح أي وصول في مؤسسة منفصلة وغير مرتبطة، على الرغم من أنه ينطبق على المؤسسات المتفرعة تحت تلك المؤسسة. هذا أمر مقصود — فهو يقصر المفتاح المخترق على مؤسسته والمؤسسات الفرعية التابعة لها، وليس المنصة بأكملها.
يغطي دور dev قراءة بيانات المؤسسة، وإدارة مفاتيح API، وعرض المواقع وإنشائها، وإعادة تشغيلها، ومسح ذاكرة التخزين المؤقت الخاصة بها، بالإضافة إلى عرض التذاكر والرد عليها. وهو يستبعد إدارة الفواتير عن قصد. يُرجى ملاحظة أن أذونات النشر والرفع إلى البيئة المباشرة (push-to-live) ليست جزءًا منه — إذا كان أحد أعضاء الفريق بحاجة إليها، فعيّن له دورًا يتضمنها بدلاً من افتراض أن Developer هو الدور التقني الأوسع نطاقًا.
تتم إعادة محاولات التسليم بتراجع تدريجي وتُسجل كل محاولة كـ WebhookDelivery يمكنك فحصه. في المصدر، تُكتب الأحداث في صندوق صادر معاملاتي (transactional outbox) ضمن نفس معاملة قاعدة البيانات الخاصة بالتغيير نفسه، بحيث لا يُفقد أي شيء أثناء عدم توفر المستهلك — فالمستهلك المتوقف يتأخر فقط، ولا يؤدي أبدًا إلى تعطيل المنتج، ويمكنك إعادة تشغيل عمليات التسليم من لوحة التحكم بمجرد عودتك.
ابدأ فترة تجريبية لمدة 14 يوماً دون الحاجة لبطاقة مع استضافة Footprint-Free — دون تفاصيل دفع، وحتى 5 مواقع. تبدأ باقات Footprint-Free المدفوعة من 6$/شهرياً لخطة PBN 5. تتضمن كل خطة ضمان استرداد الأموال لمدة 30 يوماً، وعمليات نقل مجانية، وعدم تقييد بأي مزود خدمة.
واجهة برمجة تطبيقات تعتمد على المواصفات أولاً، وحزم SDK مُنشأة، وواجهة سطر أوامر (CLI)، ومزود Terraform، وخطافات ويب (webhooks) موقعة، وخادم MCP — على الاستضافة التي بنيناها لأكثر من 700,000 موقع حول العالم. ابدأوا بتجربة مجانية لمدة 14 يومًا دون الحاجة لبطاقة، ودون أي تفاصيل دفع.
ابدأ مجانًاتجعل كل إضافة من هذه الإضافات موقع WordPress الخاص بك خادم MCP، بحيث يمكن لـ Claude و Cursor و VS Code وغيرها من مساعدي الذكاء الاصطناعي تنفيذ مهام حقيقية عليه، مسجلين الدخول بحسابك ومقيدين بالصلاحيات الممنوحة لك وحدك.