ما هو بوابة Zuplo API؟

لا تزال معظم بوابات API تبدو وكأنها صُممت لفريق عمليات عام 2014. تكتب YAML، تتصارع مع مستوى التحكم، وتنتظر شخصًا لديه صلاحية الوصول إلى المجموعة ليدفع تغييراتك. Zuplo يقلب هذا النموذج رأسًا على عقب. إنها بوابة API قابلة للبرمجة، أصلية للحافة، حيث تعيش مساراتك في مستودع Git، وسياساتك هي TypeScript، وكل عملية التزام تُنشر إلى أكثر من 300 موقع عالمي في ثوانٍ.

جرّب Apidog اليوم

يشرح هذا الدليل ما تفعله بوابة API من Zuplo، وكيف تختلف عن Kong وAWS API Gateway، وما تكلفته، وكيفية نشر أول بوابة لك في أقل من ثلاثين دقيقة. سترى أمثلة على التعليمات البرمجية للتوجيه والمصادقة وتحديد المعدل، بالإضافة إلى قسم حول اختبار كل نقطة نهاية باستخدام Apidog قبل أن تصل إلى الإنتاج.

يقع Zuplo في فئة كانت تهيمن عليها Kong وApigee وAWS API Gateway. الفكرة بسيطة: يحصل المطورون على لغة برمجة حقيقية، وتحصل العمليات على خدمة مُدارة، ويحصل المنتج على طبقة تحقيق دخل مدمجة. التنازلات وسير العمل الفعلي هي ما يوضحه هذا المنشور.

باختصار

• Zuplo هي بوابة API مُدارة بالكامل، أصلية للحافة، تشغل مساراتك عبر أكثر من 300 مركز بيانات من Cloudflare بزمن استجابة أقل من 50 مللي ثانية وعدم وجود تشغيل بارد.
• التكوين أصيل لـ GitOps؛ بوابتك تعيش في مستودع Git ويتم شحنها عبر CI/CD، وليس واجهة مستخدم.
• تتم كتابة السياسات في TypeScript بدعم كامل من بيئة التطوير المتكاملة (IDE)، وليس YAML أو Lua.
• الطبقة المجانية تغطي 100 ألف طلب شهريًا مع بيئات غير محدودة ومفاتيح API وبوابات مطورين.
• تتضمن الميزات المدمجة مصادقة بمفتاح API، وJWT، وOAuth2، وتحديد المعدل، والتحقق من الطلبات، وبوابة مطورين يتم إنشاؤها تلقائيًا، وتحقيق الدخل المدعوم بـ Stripe.
• يقوم Zuplo الآن بشحن MCP Server Handler، لذا يمكن عرض أي مسار بوابة لـ Claude أو Codex أو Cursor أو أي عميل MCP.
• اختبر كل مسار Zuplo من البداية إلى النهاية باستخدام Apidog قبل قلب المفتاح في الإنتاج.

ما هو Zuplo؟

Zuplo هي منصة لإدارة API مبنية حول ثلاث أفكار: الكود على التكوين، الحافة على المنطقة، وGit على الواجهة الرسومية. تعمل كخدمة مُدارة بالكامل على شبكة حافة Cloudflare، لذا فإن عملية نشر واحدة تصل إلى أكثر من 300 مركز بيانات دون أن تقوم بتوفير أي شيء.

بينما تتعامل معظم البوابات مع تكوينك كأداة YAML مخزنة في قاعدة بيانات مستوى التحكم، يتعامل Zuplo مع بوابتك كمشروع TypeScript. تحصل على ملف routes.oas.json يصف نقاط النهاية، ومجلد لوحدات TypeScript للمنطق المخصص، وملف تكوين للسياسات التي تقوم بتوصيلها. ادفع إلى GitHub وتقوم المنصة بالبناء والتحقق والنشر.

تدعم المنصة REST وGraphQL وgRPC وWebSockets وSOAP. وهي متوافقة مع SOC 2 Type II، وتعمل عبر الواجهات الخلفية لـ AWS وAzure وGCP، وتقدم خيار Kubernetes مستضاف ذاتيًا للفرق ذات قواعد إقامة البيانات الصارمة. تبدأ الأسعار مجانًا وتتدرج مع حجم الطلبات بدلاً من الرسوم لكل مقعد. التوزيع الكامل موجود على صفحة أسعار Zuplo.

لماذا يختار المطورون Zuplo بدلاً من Kong وApigee وAWS API Gateway

كل بوابة لها شخصيتها الخاصة. Kong هي القوة الثقيلة مفتوحة المصدر التي تمنحك أقصى قدر من التحكم وتطلب خبرة Lua في المقابل. Apigee هي منصة المؤسسات ذات التحليلات العميقة ومنحنى التعلم الحاد. AWS API Gateway هو الخيار الافتراضي إذا كانت مجموعتك موجودة بالفعل في AWS، ولكن بوابة المطورين مفقودة وعبء التشغيل البارد على تكاملات Lambda حقيقي.

تهدف Zuplo إلى مشترٍ مختلف: الفريق الصغير الذي يريد ميزات على مستوى المؤسسات دون الحاجة إلى فريق هندسة المنصات لتشغيلها.

بعض الاختلافات المحددة:

• تعليمات برمجية، وليست YAML: سياسة تحديد المعدل في Zuplo تتكون من ثلاثة أسطر من TypeScript. نفس السياسة في Kong هي ما يقرب من خمسة عشر سطرًا من YAML موصولة بمكون إضافي. إذا كنت تقضي معظم يومك في TypeScript أو JavaScript، فإن تكوين Zuplo سيبدو أصيلًا.
• بوابة مطورين متضمنة: بوابة Kong مخصصة للمؤسسات فقط. بوابة Apigee موجودة ولكن تتطلب جهدًا للعلامة التجارية. تُنشئ Zuplo بوابة مباشرة من مواصفات OpenAPI الخاصة بك على كل خطة، بما في ذلك الطبقة المجانية.
• GitOps بشكل افتراضي: كل تغيير هو طلب سحب. تحصل على مراجعات وسجلات تدقيق وgit revert مجانًا. لا توجد نقرات واجهة المستخدم لمطاردتها عندما يتعطل شيء ما في الساعة 3 صباحًا.
• أصلي للحافة، بدون تشغيل بارد: يعمل Zuplo على Cloudflare Workers، مما يعني أن كل طلب بوابة يصل إلى أقرب مركز بيانات من أصل 300+ مركز بيانات ويبدأ في بضعة أجزاء من الألف من الثانية. AWS API Gateway مع Lambda يضيف عادة تشغيل بارد ملحوظ.

إذا كان فريقك قد استثمر بالفعل في Kong أو Apigee وكان الحمل التشغيلي جيدًا، فإن التبديل نادرًا ما يستحق العناء. إذا كنت تبدأ من جديد أو إذا كانت بوابتك الحالية تؤخرك، فإن سير عمل Zuplo هو أوضح تحسين لأي منصة يتم شحنها اليوم.

الميزات الأساسية لبوابة Zuplo API

قابلية البرمجة الأولى بـ TypeScript

يتم تعريف سلوك البوابة في ملفات TypeScript بجانب مساراتك. السياسات الواردة والصادرة المخصصة هي دوال تستقبل الطلب، وتقوم بما تريد، وتعيد الطلب أو الاستجابة المعدلة. تحصل على مجموعة أدوات TypeScript الكاملة: الأنواع، والإكمال التلقائي، وإعادة الهيكلة، والاختبارات.

مثال على سياسة صادرة تزيل رأساً داخلياً:

import { ZuploRequest, ZuploContext } from "@zuplo/runtime";

export default async function (
  response: Response,
  request: ZuploRequest,
  context: ZuploContext,
) {
  response.headers.delete("x-internal-trace-id");
  return response;
}

ضع هذا الملف في modules/strip-internal-header.ts، وفعّله في مسارك، وادفع إلى Git، وسيتم نشره فوراً.

أكثر من 60 سياسة مُعدة مسبقًا

معظم الفرق لا تحتاج لكتابة كود مخصص للأساسيات. Zuplo يشحن مع أكثر من 60 سياسة تغطي مصادقة مفتاح API، JWT، OAuth 2.0، تحديد المعدل (نافذة ثابتة، نافذة منزلقة، سلة الرموز)، التحقق مقابل OpenAPI، CORS، قوائم IP، تحويل الطلبات، وغيرها. قم بتوصيلها عبر تحرير تعريف المسار فقط.

بوابة مطورين مُنشأة تلقائيًا

أشر البوابة إلى مواصفات OpenAPI الخاصة بك لتحصل على موقع توثيق مستضاف مع وحدات تحكم تجريبية تفاعلية، وعينات كود في cURL وJavaScript وPython وGo، مع إصدار مفاتيح API ذاتي الخدمة. يمكن للمستخدمين النهائيين التسجيل وإنشاء المفاتيح والبدء فورًا دون تدخلك.

تحقيق الدخل من واجهة برمجة التطبيقات المدمجة

Zuplo يتكامل مع Stripe لبيع الوصول إلى API. حدد الخطط، اربط Stripe، والبوابة تدير الدفع والاشتراكات والفوترة. هذا يوفر أسابيع من التطوير مقارنة بمعظم البوابات المنافسة.

مُعالج خادم MCP لوكلاء الذكاء الاصطناعي

أضف مُعالج MCP لتجعل واجهتك قابلة للاستدعاء عبر وكلاء الذكاء الاصطناعي مثل Claude وCodex وCursor وأي عميل MCP آخر. تنطبق نفس سياسات المصادقة وتحديد المعدل على العملاء البشريين ووكلاء الذكاء الاصطناعي. راجع دليل MCP لمزيد من التفاصيل.

نشر الحافة، زمن وصول أقل من 50 مللي ثانية

كل بوابة تُنشر تلقائيًا إلى أكثر من 300 موقع حافة Cloudflare. المنصة تدعي زمن وصول أقل من 50 مللي ثانية دون تشغيل بارد. المستخدمون العالميون يصلون إلى نقطة قريبة منهم بدون مشكلة.

كيف يعمل Zuplo تحت الغطاء

أي طلب يمر عبر المسار التالي:

1. مطابقة المسار: يطابق عنوان URL وطريقة الطلب مقابل routes.oas.json.
2. السياسات الواردة: جميع السياسات (مصادقة، تحديد معدل، إلخ) تُنفذ بالترتيب. إذا أرجعت سياسة استجابة، يُختصر المسار.
3. المعالج: يعيد التوجيه للمصدر، يعيد قيمة ثابتة، أو يشغل TypeScript مخصص، أو يدعو MCP.
4. السياسات الصادرة: تحويلات الاستجابة، إزالة الرؤوس، إلخ.
5. الاستجابة: تُعاد للعميل وتُسجل في طبقة المراقبة.

كل ذلك داخل Cloudflare Worker، لذلك لا يوجد تشغيل بارد أو دفع مقابل سعة غير مستخدمة.

إعداد أول بوابة Zuplo لك

يمكنك بناء بوابة عاملة خلال أقل من 30 دقيقة. اتبع الخطوات التالية:

1. سجل في zuplo.com وأنشئ مشروعًا جديدًا. اختر تكامل GitHub لمزامنة المشروع مع مستودع Git.
2. استورد مواصفات OpenAPI. إذا كانت لديك، استوردها مباشرة. إن لم تكن لديك، أنشئ المسارات في واجهة المستخدم ثم صدّر المواصفات لاحقًا.
3. أضف سياسة مصادقة بمفتاح API. في محرر المسارات، أضف سياسة api-key-inbound. سيُنشئ Zuplo قاعدة بيانات المستهلك وواجهة إصدار المفاتيح تلقائياً.
4. أضف حدًا للمعدل. أضف سياسة rate-limit-inbound وحدد عدد الطلبات لكل مفتاح.
5. النشر. ادفع للفرع، وسيبني Zuplo بيئة معاينة بعنوان URL فريد. انقل إلى الإنتاج بالدمج.
6. اختبر البوابة من البداية إلى النهاية. استخدم Apidog لإطلاق طلبات، التحقق من السياسات، واختبار حالات الخطأ والتحميل الزائد.

المشروع الأول يُنشر في دقائق. أصعب جزء هو تنظيم المسارات والمنطق المخصص، وهو تحدٍ مشترك بين جميع المنصات.

كتابة سياسات مخصصة في TypeScript

السياسات الجاهزة تغطي الأكثر شيوعاً. لأي حالة متقدمة، اكتب سياستك الخاصة. مثال عملي: إثراء الطلب من خدمة داخلية قبل وصوله للمصدر.

import { ZuploRequest, ZuploContext } from "@zuplo/runtime";

interface UserContext {
  userId: string;
  plan: "free" | "pro" | "enterprise";
}

export default async function (
  request: ZuploRequest,
  context: ZuploContext,
): Promise<ZuploRequest | Response> {
  const apiKey = request.user?.sub;
  if (!apiKey) {
    return new Response("Unauthorized", { status: 401 });
  }

  const lookupUrl = `https://internal.example.com/users/${apiKey}`;
  const userResponse = await fetch(lookupUrl, {
    headers: { authorization: `Bearer ${context.environment.INTERNAL_TOKEN}` },
  });

  if (!userResponse.ok) {
    return new Response("User lookup failed", { status: 502 });
  }

  const user = (await userResponse.json()) as UserContext;
  request.headers.set("x-user-id", user.userId);
  request.headers.set("x-user-plan", user.plan);
  return request;
}

• السياسة هي دالة async عادية: اختبرها كاختبار وحدة.
• المتغيرات البيئية من context.environment (آمن نوعياً).
• إعادة Response تختصر التنفيذ وتعيد الخطأ المناسب.

تسعير Zuplo في عام 2026

بسيط وواضح:

• مجاني: 100 ألف طلب شهرياً، بيئات ومفاتيح غير محدودة، 1GB خروج، نشر إلى جميع الحواف، إنتاج حقيقي.
• باني (25 دولار شهرياً): حتى مليون طلب شهرياً، نطاقان مخصصان، 1GB لكل 100 ألف طلب، طلبات إضافية بسعر 100 دولار لكل 100 ألف.
• مؤسسي (بدءًا من 1000 دولار شهريًا): طلبات ونطاقات غير محدودة، SLA حتى 99.999%، دعم GitHub Enterprise/GitLab/Azure DevOps، مراقبة متقدمة، SSO، RBAC.

منتجات الذكاء الاصطناعي وبوابة المطورين لها تسعير منفصل. راجع صفحة أسعار Zuplo للتفاصيل المحدثة.

للمقارنة: AWS API Gateway تفرض 3.50 دولار لكل مليون طلب REST، ويضاف عليها نقل البيانات وتكلفة Lambda. خدمة Kong للمؤسسات غالباً أغلى من حد Zuplo الأدنى.

متى يكون Zuplo هو الخيار الصحيح (ومتى لا يكون كذلك)

اختر Zuplo إذا:

• تحتاج إلى بوابة مُدارة بالكامل.
• فريقك يجيد TypeScript/JavaScript.
• تحتاج بوابة مطورين مدمجة.
• تريد تحقيق الدخل عبر Stripe بسرعة.
• تعرض API لوكلاء الذكاء الاصطناعي وتحتاج دعم MCP.
• حركة المرور عالمية وزمن الوصول مهم.

تجنب Zuplo إذا:

• تريد تحكمًا مفتوح المصدر كاملاً (Kong أفضل).
• بنيتك مغلقة بالكامل داخل الشركة (Kong أو Tyk المستضاف محلياً أنسب).
• تحتاج تخصيصات NGINX عميقة جداً.
• استثمرت بالفعل بكثافة في Apigee أو MuleSoft.

اختبار بوابة Zuplo الخاصة بك باستخدام Apidog

بمجرد أن تكون بوابتك جاهزة على بيئة المعاينة، اختبر كل مسار وكل سياسة قبل الإنتاج. هنا يأتي دور Apidog:

• استيراد مواصفات OpenAPI مباشرة.
• اختبار المسارات بمفاتيح صالحة وغير صالحة.
• إرسال حمولات خاطئة للتحقق من سياسات التحقق.
• اختبار حدود المعدل بالتحميل الزائد.
• حفظ متغيرات البيئة للتبديل بين المعاينة والإنتاج بسهولة.
• تصدير عينات كود مباشرة لفريقك.

يمكنك أيضًا تشغيل سيناريوهات اختبار آلية بـ Apidog. إذا لم تستخدمه من قبل، جرب ملحق Apidog لـ VS Code أو راجع دليل اختبار API بدون Postman. لتحميل الأداة مباشرة ابدأ من هنا: قم بتنزيل Apidog.

أسئلة شائعة حول بوابة Zuplo API

هل Zuplo مفتوح المصدر؟

المنطق الأساسي مغلق المصدر، لكن Zuplo قام بفتح مصدر بوابة المطورين والعديد من المكتبات الداعمة على GitHub. إذا احتجت لاستضافة ذاتية، بوابة المصدر المفتوح وخيار Kubernetes يغطيان معظم الاحتياجات، لكن معظم الفرق تبقى على الخدمة المُدارة.

هل يمكن لـ Zuplo أن يعمل على بنيتي التحتية الخاصة بي؟

نعم، خطة Enterprise تشمل خيار Kubernetes المستضاف ذاتيًا. لكنك تتخلى عن النشر العالمي وتتولى العمليات بنفسك. مناسب للفرق التي لديها متطلبات إقامة بيانات صارمة.

كيف يقارن Zuplo بـ Cloudflare API Shield؟

API Shield منتج أمني (تحقق مخطط، mTLS، إلخ) ويعمل أمام أي مصدر. Zuplo منصة إدارة API كاملة: توجيه، سياسات، بوابة مطورين، تحقيق الدخل، دعم MCP. يمكن الجمع بين الاثنين حسب الحاجة.

هل يعمل Zuplo مع مواصفات OpenAPI الموجودة لدي؟

نعم. OpenAPI هو مصدر الحقيقة في Zuplo. استورد المواصفات لتظهر المسارات وتُنشئ بوابة المطورين وتُطبق سياسات التحقق تلقائياً.

هل يمكنني عرض بوابة Zuplo الخاصة بي لوكلاء الذكاء الاصطناعي مثل Claude أو Codex؟

نعم، عبر MCP Server Handler. أشر المعالج إلى مواصفات OpenAPI وحدد العمليات، وستصبح البوابة قابلة للاستدعاء من أي عميل MCP، مع تطبيق نفس السياسات.

كم يستغرق نشر Zuplo؟

دورة النشر للمعاينة عادة أقل من 60 ثانية. الترقية للإنتاج أسرع. لا توجد فترات صيانة، العمليات ذرية.

ماذا يحدث إذا تعطلت Cloudflare؟

Zuplo يعمل على شبكة حافة Cloudflare، وأي انقطاع إقليمي يؤثر على تلك المنطقة. خطة Enterprise تدعم تجاوز الفشل متعدد السحب. معظم الفرق تقبل اعتماد Cloudflare نظراً لسجله العالي.

الخلاصة

Zuplo هي بوابة API للفرق التي تحتاج ميزات على مستوى المؤسسات دون تعقيد التشغيل. السياسات عبر TypeScript، GitOps، بوابة المطورين المدمجة، تحقيق الدخل، ودعم MCP يجعلها منصة متكاملة. الطبقة المجانية كافية لحركة إنتاج حقيقية، وخطة Enterprise تغطي سيناريوهات المؤسسات.

ابدأ خلال نصف ساعة مع أحد واجهات برمجة التطبيقات لديك، واختبر كل سياسة عبر Apidog، واتخذ قرارك بناءً على نتائج عملية وليس صفحات تسويق. الجمع بين بوابة حافة مُدارة وأداة اختبار قوية هو أسرع طريق لتحويل API إلى منتج حقيقي. قم بتنزيل Apidog وابدأ الاختبار.