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

Ashley Innocent

Ashley Innocent

27 أبريل 2026

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

Apidog للمؤسسات

النشر على الخوادم المحلية

SSO و RBAC

متوافق مع SOC 2

استكشف Apidog للمؤسسات

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

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

زر

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

باختصار

ما هو Zuplo؟

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

تكوين Zuplo GitOps

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

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

مقارنة أسعار Zuplo

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

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

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

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

إذا كان فريقك قد استثمر بالفعل في 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 ذاتي الخدمة. يمكن للمستخدمين النهائيين التسجيل وإنشاء مفاتيح وبدء استدعاء API دون تدخل بشري واحد. بالنسبة لواجهات برمجة التطبيقات SaaS التي تعتمد على اعتماد المطورين، هذا وحده غالبًا ما يبرر المنصة.

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

يشحن Zuplo تكامل Stripe لبيع الوصول إلى API. يمكنك تحديد الخطط (مجانية، احترافية، مؤسسية)، وتوصيل Stripe، وتتولى البوابة عملية الدفع، وإدارة الاشتراكات، وفواتير الاستخدام. هذا نادر في بوابات API؛ Kong وAWS API Gateway يتركان تحقيق الدخل كـ"تمرين للقارئ". إذا كنت تفرض رسومًا على مكالمات API، فإن تدفق تحقيق الدخل من Zuplo يلغي بناءً متعدد الأسابيع.

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

أحدث إضافة هي مُعالج خادم MCP. وجّهه إلى مواصفات OpenAPI الخاصة بك، واختر العمليات التي تريد عرضها، وستصبح واجهة برمجة التطبيقات الحالية قابلة للاستدعاء بواسطة Claude Code وOpenAI Codex وCursor وأي عميل آخر متوافق مع MCP. تنطبق نفس سياسات المصادقة وتحديد المعدل التي طبقتها على المتصلين البشريين على وكلاء الذكاء الاصطناعي. نشر Zuplo دليلًا تفصيليًا حول عرض واجهات برمجة التطبيقات من خلال MCP يغطي التكوين بالتفصيل.

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

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

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

يصل طلب إلى أقرب موقع حافة ويمر عبر هذا المسار:

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

يعمل كل هذا في Cloudflare Worker، وهذا هو السبب في أن أرقام زمن الوصول تصمد ولماذا لا تدفع مقابل السعة الخاملة.

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

يمكنك بناء بوابة عاملة في حوالي ثلاثين دقيقة. إليك شكل سير العمل:

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

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

كتابة سياسات مخصصة في 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;
}

ثلاثة أشياء جديرة بالملاحظة هنا. أولاً، السياسة هي دالة غير متزامنة عادية؛ اختبارها هو اختبار وحدة، وليس اختبار تكامل ثقيل التجهيزات. ثانيًا، المتغيرات البيئية تأتي من context.environment، وهي آمنة من حيث النوع ويتم سحبها من إعدادات مشروعك. ثالثًا، إعادة Response يختصر مسار الأنابيب، وهذا هو كيف تعبر عن فشل المصادقة أو الأخطاء الأولية بشكل نظيف.

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

تسعير Zuplo بسيط بشكل غير عادي لهذه الفئة. ثلاث خطط:

منتجات بوابة الذكاء الاصطناعي وبوابة المطورين لها مستويات منفصلة، بما في ذلك بوابة مستضافة ذاتيًا مفتوحة المصدر بسعر 0 دولار شهريًا. الأرقام الحالية موجودة على صفحة أسعار Zuplo وتستحق التحقق منها قبل توقيع العقد.

للمقارنة: تفرض AWS API Gateway رسومًا قدرها 3.50 دولار لكل مليون طلب REST، ثم نقل البيانات، ثم تكاليف Lambda إذا كنت تستخدم تكاملات Lambda. مستوى Kong للمؤسسات مخصص ويتجاوز تاريخياً الحد الأدنى لـ Zuplo البالغ 1000 دولار. الطبقة المجانية وحدها تجعل Zuplo صعب المنافسة للمشاريع الناشئة.

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

يتناسب Zuplo بشكل جيد عندما:

Zuplo هو الخيار الخاطئ عندما:

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

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

يستورد Apidog مواصفات OpenAPI الخاصة بك مباشرة، لذا فإن نفس المواصفات التي تدعم مسارات Zuplo الخاصة بك تدعم أيضًا مجموعة الاختبارات الخاصة بك. من هناك يمكنك:

يمكنك أيضًا تشغيل سيناريوهات اختبار Apidog الآلية ضد البوابة، وهو أسرع من كتابة نصوص برمجية لمرة واحدة. إذا لم تكن قد استخدمت 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. يمكن للمنتجين التعايش. إذا كنت تحتاج فقط إلى إشارات الأمان، فإن API Shield كافٍ. إذا كنت بحاجة إلى دورة الحياة الكاملة، فإن Zuplo هي المنصة.

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

نعم. OpenAPI هو مصدر الحقيقة في Zuplo. قم باستيراد المواصفات، وستظهر المسارات، وتُنشئ بوابة المطورين من نفس المواصفات، وتستخدم سياسات التحقق من الطلب نفس المخططات. إذا كانت مواصفاتك فوضوية، فإن عملية الاستيراد هي اللحظة التي تكتشف فيها ذلك.

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

نعم، من خلال مُعالج خادم MCP. توجه المعالج إلى مواصفات OpenAPI الخاصة بك، واختر العمليات التي تريد عرضها، وستصبح البوابة قابلة للاستدعاء بواسطة أي عميل متوافق مع MCP. تنطبق نفس سياسات المصادقة وتحديد المعدل التي حددتها للمتصلين البشريين تلقائيًا.

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

تستغرق دورة الدفع للنشر عادة أقل من ستين ثانية لبيئة المعاينة. عمليات الترقية إلى الإنتاج أسرع لأن الأداة تم بناؤها بالفعل. لا توجد فترات صيانة؛ عمليات النشر ذرية.

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

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

الخلاصة

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

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

زر

ممارسة تصميم API في Apidog

اكتشف طريقة أسهل لبناء واستخدام واجهات برمجة التطبيقات