أفضل بديل للمنحل

Apiary قيد الإغلاق. نشرت Oracle إعلانًا بإنهاء دعم Apiary، وتشير التقارير في مجال أدوات API إلى الإغلاق النهائي للخدمة المستضافة حوالي سبتمبر 2026. لا يزال الموقع يعمل اليوم، لكن المسار كان واضحًا لسنوات: استحوذت Oracle على Apiary في يناير 2017، وأوقفت الخطط المدفوعة في عام 2018، وتركت الأدوات مفتوحة المصدر المحيطة، مثل Dredd وGavel، في حالة أرشيف. إذا كانت وثائق API الخاصة بك موجودة على apiary.io، فأنت لا تقارن البدائل بعد الآن؛ أنت تهاجر، والموعد النهائي ليس بيدك.

جرّب Apidog اليوم

الإجابة المباشرة: Apidog بديل عملي لـ Apiary لأنه يغطي تحرير المواصفات بأسلوب التصميم أولًا، والوثائق التفاعلية المستضافة، والخادم الوهمي. كما يضيف اختبار API الآلي، والتحقق من صحة المواصفات بدلًا من Dredd المؤرشف، وتكامل CI. وهو مجاني لما يصل إلى 4 مستخدمين، مع خطط مدفوعة تبدأ من 9 دولارات لكل مستخدم شهريًا. النقطة المهمة: لا يستورد Apidog ملفات API Blueprint مباشرة، لذلك تحتاج مشاريع Blueprint إلى تحويل لمرة واحدة إلى OpenAPI. يشرح هذا الدليل ما يجب تصديره، وكيفية التحويل، وكيفية إكمال الترحيل.

ما الذي يحدث بالفعل لـ Apiary؟

Apiary، التي تأسست عام 2011، ساعدت في انتشار سير عمل API القائم على التصميم أولًا. قدمت API Blueprint، وهو تنسيق لوصف API يعتمد على Markdown قبل انتشار OpenAPI، بالإضافة إلى تخطيط الوثائق ذي الأعمدة الثلاثة الذي اشتهرت به Stripe ونسخه كثيرون.

كما جمعت بين:

• خادم وهمي مستضاف
• مزامنة GitHub
• وثائق تفاعلية
• أدوات اختبار العقود مفتوحة المصدر: Dredd وGavel

بعد استحواذ Oracle عليها في يناير 2017، دخل المنتج فترة هدوء طويلة. أوقفت Oracle المستويات المدفوعة في 2018، وتم أرشفة Dredd وGavel، وأصبح إنهاء الدعم رسميًا. يشير دليل الوداع من Bump.sh إلى الإغلاق المتوقع للخدمة المستضافة حوالي سبتمبر 2026.

النتيجة العملية بسيطة:

1. صدّر كل ما لديك من Apiary الآن.
2. انقل مواصفات API Blueprint إلى OpenAPI.
3. انقل الوثائق، وعناوين الخادم الوهمي، وفحوصات العقود قبل الإغلاق.

ما الذي ستقوم باستبداله؟

قبل اختيار منصة بديلة، حدّد ما كان Apiary يفعله لفريقك:

• محرر مواصفات قائم على التصميم أولًا: كنت تكتب API Blueprint أو OpenAPI 3.0 في المتصفح.
• وثائق تفاعلية مستضافة: مرجع API مع أمثلة طلبات على عنوان URL من apiary.io.
• خادم وهمي: نقطة نهاية مستضافة تعيد أمثلة المواصفات للمستهلكين قبل جاهزية الواجهة الخلفية.
• مزامنة GitHub: ملف المواصفات في المستودع ويتزامن مع المشروع.
• اختبار العقود عبر Dredd: تشغيل المواصفة مقابل تطبيق حقيقي واكتشاف الانحرافات. Dredd مؤرشف الآن؛ راجع كيفية التحقق من صحة API مقابل مواصفاته بدون Dredd.

البديل المناسب لا يجب أن يكون مجرد عارض وثائق. يجب أن يغطي التصميم، والوثائق، والمحاكاة، والتحقق من الصحة.

الجواب: Apidog

Apidog منصة لتطوير واجهات برمجة التطبيقات تستخدمها أكثر من 500,000 مطور. تغطي دورة العمل نفسها التي بدأت بها Apiary: التصميم، والتوثيق، والمحاكاة، وتصحيح الأخطاء، والاختبار الآلي من مواصفة واحدة.

بالنسبة للترحيل من Apiary، ركّز على هذه النقاط:

1. التصميم أولًا هو سير العمل الافتراضي.
   
   يدعم Apidog محررًا مرئيًا ومحرر كود لمواصفات OpenAPI 3.x. عرّف نقاط النهاية والمخططات والأمثلة مرة واحدة، ثم استخدمها لتوليد الوثائق والمحاكاة والاختبارات.

2. وثائق مستضافة وتفاعلية.
   
   يمكنك نشر مرجع API مع وحدة تحكم “جرّبها”، ونطاق مخصص، وإصدارات. لا تعتمد على عنوان URL في apiary.io قد يختفي عند الإغلاق.

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

4. بديل عملي لـ Dredd.
   
   تستطيع سيناريوهات الاختبار في Apidog إرسال طلبات حقيقية إلى تطبيقك والتحقق من الاستجابات مقابل مخططات OpenAPI، مع تأكيدات وتشغيل CI عبر Apidog CLI. كما يمكن نشر الوثائق بجانب خادم MCP؛ راجع ما هو Apidog MCP Server.

الترحيل من Apiary، خطوة بخطوة

يتضمن هذا الترحيل خطوة إضافية: Apidog يستورد OpenAPI وSwagger 2.0 ومجموعات Postman وHAR وRAML وJMeter وapiDoc وI/O Docs وWADL وGoogle Discovery، وفقًا لـوثائق الاستيراد. أما API Blueprint فليس ضمن التنسيقات المدعومة مباشرة.

1. صدّر كل شيء من Apiary الآن

لكل مشروع:

1. نزّل وصف API من محرر Apiary.
2. إذا كان المشروع متزامنًا مع GitHub، تأكد أن المستودع يحتوي أحدث نسخة.
3. احتفظ بنسخة من:
   • ملف المواصفة
   • نصوص الوثائق
   • أمثلة الطلبات والاستجابات
   • إعدادات المصادقة
   • روابط الخادم الوهمي التي يستخدمها المستهلكون

مشاريع Apiary التي كُتبت أصلًا بـ OpenAPI 3.0 يمكنها تجاوز خطوة التحويل.

2. حوّل API Blueprint إلى OpenAPI

استخدم أحد المحولات التالية:

• api-spec-converter من LucyBot
• apib2swagger
• openapi-format لتوحيد الناتج أو ترقيته لاحقًا إلى OpenAPI 3.1

بعد التحويل، افحص ملف OpenAPI الناتج باستخدام مدقق مثل vacuum أو مدقق OpenAPI الموجود في سلسلة أدواتك.

ركز يدويًا على نقطتين:

• المصادقة: لم يكن API Blueprint ينمذج مخططات المصادقة رسميًا بشكل كامل، لذلك قد لا يستعيدها المحول.
• النصوص الحرة: راجع الشروحات المكتوبة في أقسام Markdown، خصوصًا إن كانت تحتوي متطلبات أو قيودًا لم تُحوّل إلى أوصاف نقاط النهاية.

مثال على ما يجب مراجعته وإضافته يدويًا عند غياب المصادقة من الملف الناتج:

components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT

security:
  - bearerAuth: []

لا تتعامل مع التحويل كمشروع إعادة تصميم. غالبًا تحتاج إلى مراجعة عملية للمخططات والمصادقة، لا إلى إعادة كتابة API بالكامل.

3. استورد ملف OpenAPI إلى Apidog

بعد تجهيز ملف OpenAPI:

1. افتح إعدادات المشروع في Apidog.
2. اختر الاستيراد اليدوي.
3. حدّد ملف OpenAPI أو استورده من URL.
4. راجع نقاط النهاية والمخططات والأمثلة المستوردة.
5. انشر الوثائق وفعّل رابط الخادم الوهمي للمستهلكين.

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

4. أعد بناء الأجزاء التشغيلية

لا تكتفِ باستيراد المواصفة. أكمل هذه المهام:

• وجّه نطاقًا مخصصًا إلى الوثائق المنشورة.
• أعد إنشاء فحوصات Dredd كسيناريوهات اختبار.
• نفّذ طلبات حقيقية ضد بيئة اختبار أو Staging.
• أضف تحققًا من مخطط الاستجابة.
• شغّل السيناريوهات محليًا أو في CI عبر CLI.
• أرسل للمستهلكين رابط الوثائق الجديد ورابط الخادم الوهمي الجديد.

مشروع API واحد يمكن أن ينتقل خلال فترة بعد الظهر، بما في ذلك التحويل. أما محفظة من واجهات API Blueprint فستحتاج غالبًا إلى وقت إضافي لمراجعة المصادقة يدويًا.

نظرة سريعة على Apiary مقابل Apidog

	Apiary اليوم	Apidog
المستقبل	سيتم إغلاقه؛ تم إنهاء الدعم، ومن المتوقع انتهاء الخدمة حوالي سبتمبر 2026	يتم تطويره بنشاط
تنسيق المواصفات	API Blueprint، ولاحقًا OpenAPI 3.0	OpenAPI 3.x مع استيراد Swagger 2.0 ومحررات مرئية وكود
الوثائق المستضافة	نعم، على عناوين apiary.io	نعم، نطاق مخصص، إصدارات، ووحدة تحكم “جرّبها”
الخادم الوهمي	يعيد تشغيل الأمثلة المكتوبة	محاكاة مدركة للمخطط مع قواعد مخصصة
اختبار العقود	Dredd، وهو مؤرشف	سيناريوهات اختبار، تحقق من المخطط، وCI عبر CLI
مجموعات الاختبار الآلية	لا	نعم، سيناريوهات مرئية ومدفوعة بالبيانات
مزامنة GitHub	نعم	استيراد أو مزامنة المواصفات من URL أو ملف، وإصدارات تعتمد على الفروع
السعر	مجاني، والخطط المدفوعة متوقفة منذ 2018	مجاني حتى 4 مستخدمين، ثم 9 دولارات لكل مستخدم شهريًا
مسار التصدير	تنزيل API Blueprint أو OpenAPI	تصدير OpenAPI وMarkdown وHTML

تكلفة استبدال أداة مجانية

كان سعر Apiary من أهم مزاياه المتبقية. باستخدام الأسعار المعلنة، تكون المقارنة السنوية كالتالي: Apidog مجاني حتى 4 مستخدمين ثم 9 دولارات لكل مستخدم شهريًا، وSwaggerHub Team بسعر 34.44 دولارًا لكل مستخدم شهريًا، وReadMe Pro بسعر 250 دولارًا شهريًا عند الدفع السنوي.

حجم الفريق	Apidog سنويًا	SwaggerHub Team سنويًا	ReadMe Pro سنويًا
3 أشخاص	0 دولار	1,240 دولار	3,000 دولار
5 أشخاص	540 دولار	2,066 دولار	3,000 دولار
10 أشخاص	1,080 دولار	4,133 دولار	3,000 دولار
25 شخصًا	2,700 دولار	10,332 دولار	3,000 دولار

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

إذا لم يكن Apidog هو الخيار المناسب

“الاستمرار في استخدام Apiary” ليس خيارًا طويل الأمد، لكن قد تختلف وجهتك حسب احتياجك:

• تريد عرض الوثائق فقط:
  
  إذا كانت مواصفاتك تُنتج وتُختبر في مكان آخر، وتحتاج فقط إلى وثائق مستضافة وسجل تغييرات، فإن Bump.sh خيار معقول. ستحتاج مع ذلك إلى تحويل Blueprint إلى OpenAPI.

• أنت موحّد على حزمة SmartBear:
  
  SwaggerHub قريب فلسفيًا من فكرة سجل المواصفات المستضاف في Apiary. انتبه إلى التكلفة لكل مقعد وعمليات الاختبار المقننة. راجع أفضل بديل لـ SwaggerHub.

• فريق منصة كبير يركز على الحوكمة:
  
  توفر Stoplight أدوات متعمقة للإرشادات والحوكمة. راجع أفضل بديل لـ Stoplight قبل الالتزام.

• ما زلت مرتبطًا بـ API Blueprint:
  
  لا تبنِ خطتك على تنسيق لم تعد أدواته مدعومة. حوّله مرة واحدة إلى OpenAPI وانتقل. يمكن أن يبقى دليل API Blueprint مرجعًا تاريخيًا.

الأسئلة الشائعة

متى سيتم إيقاف تشغيل Apiary؟

أعلنت Oracle إنهاء دعم Apiary، وتشير تقارير بائعي أدوات API إلى إغلاق الخدمة المستضافة حوالي سبتمبر 2026. التصرف الآمن هو التصدير الآن.

هل يمكن لـ Apidog استيراد API Blueprint مباشرة؟

لا. استورد ملف OpenAPI أو Swagger بعد تحويل API Blueprint باستخدام أداة مثل api-spec-converter أو apib2swagger. راجع مخططات المصادقة يدويًا بعد التحويل.

ماذا يحل محل خادم Apiary الوهمي؟

الخادم الوهمي الذكي المدمج في Apidog. ينشئ استجابات من المخططات، مع إمكانية تحديد قواعد وهمية مخصصة لحالات محددة.

ماذا يحل محل Dredd لاختبار العقود؟

سيناريوهات الاختبار الآلية في Apidog. ترسل طلبات حقيقية إلى تطبيقك، وتتحقق من الاستجابات مقابل مخططات المواصفة، وتدعم التأكيدات والتشغيل عبر CI باستخدام CLI.

هل Apidog مجاني لفريق صغير؟

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

صدّر اليوم، لا تعِد التصميم

رتّب العملية بهذا التسلسل:

1. صدّر مشاريع Apiary.
2. حوّل API Blueprint إلى OpenAPI.
3. راجع المصادقة والأوصاف المهمة.
4. استورد المواصفة إلى منصة الوجهة.
5. انشر الوثائق، وحدّث روابط المحاكاة، وأعد بناء اختبارات العقود.

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