Apiary قيد الإغلاق. نشرت Oracle إعلانًا بإنهاء دعم Apiary، وتشير التقارير في مجال أدوات API إلى الإغلاق النهائي للخدمة المستضافة حوالي سبتمبر 2026. لا يزال الموقع يعمل اليوم، لكن المسار كان واضحًا لسنوات: استحوذت Oracle على Apiary في يناير 2017، وأوقفت الخطط المدفوعة في عام 2018، وتركت الأدوات مفتوحة المصدر المحيطة (Dredd، Gavel) تتحول إلى حالة الأرشيف. إذا كانت وثائق API الخاصة بك موجودة على apiary.io، فأنت لم تعد تقيّم البدائل. أنت تقوم بالترحيل، والموعد النهائي ليس من حقك تأجيله.
إليك الإجابة المباشرة: Apidog هو أفضل بديل لـ Apiary، لأنه يحل محل كل ما كانت Apiary تفعله (تحرير المواصفات المبني على التصميم أولاً، وثائق تفاعلية مستضافة، خادم وهمي) ويضيف الأجزاء التي لم تكملها Apiary أبدًا: اختبار API الآلي، والتحقق من صحة المواصفات المدفوعة لتحل محل Dredd المؤرشف الآن، وتكامل CI. إنه مجاني لما يصل إلى 4 مستخدمين، مع خطط مدفوعة تبدأ من 9 دولارات لكل مستخدم شهريًا. النقطة الوحيدة الصادقة هي أن Apidog لا يستورد ملفات API Blueprint مباشرة، لذا تحتاج المشاريع المستندة إلى Blueprint إلى تحويل لمرة واحدة إلى OpenAPI عند الخروج. تغطي هذه المقالة ما يحدث لـ Apiary، ومسار الترحيل الدقيق بما في ذلك خطوة التحويل هذه، والبديل المناسب إذا لم يكن Apidog هو الخيار.
ما الذي يحدث بالفعل لـ Apiary
Apiary، التي تأسست عام 2011، اخترعت فعليًا سير عمل API القائم على التصميم أولاً كمنتج. لقد قدمت للعالم API Blueprint، وهو تنسيق لوصف API يعتمد على Markdown من الحقبة التي سبقت فوز OpenAPI، بالإضافة إلى تخطيط الوثائق ذي الأعمدة الثلاثة الذي اشتهرت به Stripe ونسخه الجميع. وقد جمعت خادمًا وهميًا مستضافًا، ومزامنة GitHub، وزوجًا من أدوات اختبار العقود مفتوحة المصدر المحبوبة، Dredd و Gavel.
ثم اشترتها Oracle في يناير 2017، ودخل المنتج فترة هدوء طويلة. تم إيقاف المستويات المدفوعة في عام 2018، تاركًا Apiary كخدمة مجانية قديمة بينما وجهت Oracle العملاء من الشركات إلى Oracle API Platform Cloud. توقف تطوير الميزات الجديدة. تم أرشفة Dredd و Gavel. والآن النهاية الرسمية: إعلان Oracle بإنهاء الدعم، مع توقع توقف الخدمة المستضافة حوالي سبتمبر 2026. Bump.sh، أحد البائعين الذين ينشرون أدلة الترحيل، صرح بذلك بوضوح في منشور الوداع: قم بتصدير أوصاف API الخاصة بك قبل الإغلاق، لأنه بعد ذلك لن يكون هناك شيء لتصديره.
تترتب على ذلك نتيجتان عمليتان. أولاً، أي شيء موجود فقط داخل Apiary (أوصاف API، نصوص الوثائق، تكوين الفريق) يحتاج إلى المغادرة الآن، بينما لا تزال أزرار التصدير تعمل. ثانيًا، نظرًا لأن API Blueprint لا يحتوي على أداة خلفية مدعومة، فإن الترحيل هو أيضًا ترحيل تنسيق: تنسيق الوجهة المعقول هو OpenAPI، بغض النظر عن النظام الأساسي الذي تستقر عليه.
ما الذي ستقوم باستبداله
من المفيد أن تكون دقيقًا بشأن ما كانت Apiary تفعله بالفعل لفريقك، لأن البديل يجب أن يغطي كل جزء:
- محرر مواصفات قائم على التصميم أولاً. كنت تكتب API Blueprint (أو، في المشاريع اللاحقة، OpenAPI 3.0) في المتصفح، وتتحدث الوثائق مباشرة.
- وثائق تفاعلية مستضافة. المرجع ذو الأعمدة الثلاثة مع أمثلة الطلبات، على عنوان URL apiary.io.
- خادم وهمي. حصل كل مشروع Apiary على نقطة نهاية وهمية مستضافة تقدم الأمثلة من مواصفاتك، بحيث يمكن للمستهلكين التكامل قبل وجود الواجهة الخلفية.
- مزامنة GitHub. كان ملف المواصفات موجودًا في مستودعك ويتزامن في الاتجاهين.
- اختبار العقود عبر Dredd. المشغل مفتوح المصدر الذي يعيد تشغيل مواصفاتك مقابل تطبيق حقيقي ويبلغ عن الانحراف. تم أرشفته الآن؛ قمنا بتغطية مشكلة الاستبدال في كيفية التحقق من صحة API الخاص بك مقابل مواصفاته بدون Dredd.
هذه الحزمة (التصميم، الوثائق، الوهمي، التحقق من الصحة) هي بالضبط شكل منصة تطوير API الحديثة. ولهذا السبب، فإن أفضل هدف للترحيل ليس مجرد عارض وثائق، بل منصة بنفس الشكل وبتطوير نشط وراءها.
الجواب: Apidog
Apidog هي منصة لتطوير واجهات برمجة التطبيقات (API) يستخدمها أكثر من 500,000 مطور. تغطي الدورة الكاملة التي رسمتها Apiary في عام 2011 ثم توقفت عن بنائها: التصميم، التوثيق، المحاكاة، تصحيح الأخطاء، والاختبار الآلي، وكلها مدفوعة بمواصفة واحدة.
بالنسبة لمن يهاجرون من Apiary تحديدًا:
- التصميم أولاً هو سير العمل الافتراضي. يحتوي Apidog على محرر مواصفات مرئي ومحرر تعليمات برمجية لـ OpenAPI 3.x. يمكنك تعريف نقاط النهاية والمخططات والأمثلة مرة واحدة؛ يتم إنشاء الوثائق والمحاكاة والاختبارات كعرض لهذا التعريف، وهي نفس الفلسفة التي ابتكرتها Apiary، مع منتج مدعوم خلفها.
- الوثائق مستضافة وتفاعلية وخاصة بك. تحصل الوثائق المنشورة على تخطيط مرجعي حديث مع وحدة تحكم "جربها" عاملة، على نطاق مخصص، مع إصدارات. لا يوجد عنوان URL apiary.io لتخسره عند الإغلاق.
- الخادم الوهمي أذكى من الذي ستتركه. كان خادم Apiary الوهمي يعيد تشغيل الأمثلة المكتوبة. يولد خادم Apidog الوهمي الذكي استجابات واقعية من مخططاتك بمجرد وجود المواصفات، لا حاجة لأمثلة، ويمكنك إضافة قواعد وهمية مخصصة حيث تكون الحتمية مهمة.
- التحقق من صحة العقد يحل محل Dredd. تقوم سيناريوهات اختبار Apidog الآلية بتشغيل طلبات حقيقية مقابل تطبيقك والتحقق من صحة الاستجابات مقابل مخططات المواصفات، وهي المهمة التي كان يقوم بها Dredd، بالإضافة إلى التأكيدات، وحالات تعتمد على البيانات، وتشغيل CI عبر Apidog CLI. يتم نشر الوثائق أيضًا جنبًا إلى جنب مع خادم MCP، بحيث يمكن لوكلاء الذكاء الاصطناعي قراءة مواصفاتك مباشرة؛ التفاصيل في ما هو Apidog MCP Server.
الترحيل من Apiary، خطوة بخطوة
يتضمن الترحيل خطوة إضافية مقارنة بتبديل أداة عادية، ومن الأفضل أن نقول ذلك مقدمًا: يستورد Apidog تنسيقات OpenAPI (Swagger 2.0، OpenAPI 3.0 و 3.1)، مجموعات Postman، HAR، RAML، JMeter، apiDoc، I/O Docs، WADL، و Google Discovery، وفقًا لوثائق استيراد Apidog. API Blueprint ليس ضمن هذه القائمة، لذا يتم تحويل مشاريع Blueprint إلى OpenAPI أولاً. عمليًا، هذه عملية أمر لمرة واحدة، وهي نفس الخطوة التي تتطلبها كل وجهة جادة أخرى، لأنه لا أحد يدعم أدوات Blueprint بعد الآن.
1. قم بتصدير كل شيء من Apiary الآن
لكل مشروع، قم بتنزيل وصف API من محرر Apiary. إذا كان المشروع يتزامن مع GitHub، فإن مصدر الحقيقة الخاص بك موجود بالفعل في المستودع؛ تأكد من أنه محدث. مشاريع Apiary اللاحقة المؤلفة في OpenAPI 3.0 هي بالفعل بالتنسيق الصحيح ويمكنها تخطي الخطوة 2. قم بذلك أولاً وبشكل كامل، قبل لمس أي شيء آخر: عمليات التصدير هي الخطوة التي لها موعد نهائي.
2. تحويل API Blueprint إلى OpenAPI
استخدم أحد المحولات المدعومة:
api-spec-converter(LucyBot)، الذي يتعامل مع API Blueprint إلى OpenAPI مباشرةًapib2swagger، محول Blueprint إلى Swagger/OpenAPI متخصصopenapi-formatبعد ذلك، إذا كنت ترغب في توحيد الإخراج وترقيته إلى OpenAPI 3.1
ثم قم بفحص النتيجة (باستخدام مدقق مثل vacuum، أو أي مدقق OpenAPI في سلسلة أدواتك) وتحقق يدويًا من نقطتين ضعيفتين معروفتين: مخططات المصادقة، التي لم ينمذجها API Blueprint رسميًا أبدًا، وبالتالي لا يمكن للمحولات استعادتها بالكامل، وأي نص نثري كان موجودًا في أقسام Markdown الخاصة بـ Blueprint بدلاً من أوصاف نقاط النهاية. خصص ساعة لكل API، وليس أسبوعًا؛ التنسيق هو Markdown، وليس سحرًا.
3. الاستيراد إلى Apidog
إعدادات المشروع، استيراد يدوي، حدد ملف OpenAPI الخاص بك (أو استورد من عنوان URL). تصل نقاط النهاية والمخططات والأمثلة منظمة ومجمعة. تتوفر الوثائق المرجعية على الفور، ويعمل خادم المحاكاة الذكي لكل نقطة نهاية مستوردة دون مزيد من الإعداد، مما يستعيد قدرة "عنوان URL للمحاكاة للمستهلكين" التي وفرتها لك Apiary.
4. إعادة بناء الأجزاء التي لم تستطع Apiary القيام بها على أي حال
وجّه نطاقًا مخصصًا إلى وثائقك المنشورة، بحيث لا يؤدي إيقاف تشغيل أي منصة تالية (أي منصة) إلى فقدان عنوان URL لوثائقك. أعد إنشاء فحوصات Dredd الخاصة بك كسيناريوهات اختبار Apidog: طلبات حقيقية، التحقق من صحة المخطط مقابل المواصفات، التشغيل محليًا أو في CI عبر CLI. إذا كان فريقك لديه مستهلكون يعتمدون على عنوان URL الوهمي الخاص بـ Apiary، أرسل لهم عنوان URL الأساسي الجديد للوهمي في نفس البريد الإلكتروني الذي يعلن عن نقل الوثائق.
مشروع API واحد ينتقل في فترة ما بعد الظهر، بما في ذلك التحويل. محفظة من اثني عشر واجهة برمجة تطبيقات Blueprint هي سباق سريع، ومعظمها يتعلق بالتحقق اليدوي من مخطط المصادقة.
نظرة سريعة على Apiary مقابل Apidog
| Apiary (اليوم) | Apidog | |
|---|---|---|
| المستقبل | سيتم إغلاقه؛ تم إنهاء الدعم، ومن المتوقع انتهاء الخدمة حوالي سبتمبر 2026 | يتم تطويره بنشاط |
| تنسيق المواصفات | API Blueprint، لاحقًا OpenAPI 3.0 | OpenAPI 3.x (استيراد Swagger 2.0)، محررات بصرية + تعليمات برمجية |
| الوثائق المستضافة | نعم، على عناوين URL 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 المجانية كل ذلك لما يصل إلى 4 مستخدمين، مما يعني لكثير من لاجئي Apiary أن تكلفة الترحيل هي بالضبط فترة ما بعد الظهر للتحويل.
إذا لم يكن Apidog هو الخيار المناسب
قسم صادق، بما أن "الاستمرار في استخدام Apiary" ليس مطروحًا:
- أنت تريد فقط عرض الوثائق، لا شيء آخر. إذا تم إنتاج مواصفاتك واختبارها في مكان آخر وكل ما تحتاجه هو وثائق مستضافة جميلة مع أدوات سجل التغيير، فإن منتجًا يركز على الوثائق مثل Bump.sh (الذي يقدم دليل ترحيل جيد جدًا لمستخدمي Apiary) هو مكان هبوط معقول. ستظل بحاجة إلى تحويل Blueprint إلى OpenAPI للوصول إلى هناك.
- أنت توحّد على حزمة SmartBear. SwaggerHub هو الأقرب فلسفيًا لفكرة سجل المواصفات المستضاف من Apiary. كن على دراية بالتكلفة لكل مقعد وعمليات الاختبار المقننة؛ لقد فصّلنا ذلك في أفضل بديل لـ SwaggerHub.
- مركز ثقلك هو إدارة التصميم لفريق منصة كبير. قامت Stoplight ببناء أدوات عميقة للدليل الإرشادي والحوكمة؛ راجع أفضل بديل لـ Stoplight لترى كيف يقارن قبل الالتزام.
- أنت مرتبط عاطفيًا بـ API Blueprint. متعاطف، ولكن لا تفعل. أدوات التنسيق غير مدعومة، والشركة التي أنشأتها يتم إيقاف تشغيلها، وقد فاز OpenAPI. قم بالتحويل مرة واحدة ولا تفكر في الأمر مرة أخرى. دليلنا الأقدم لـ API Blueprint يمكن أن يبقى قراءة تاريخية.
الأسئلة الشائعة
متى بالضبط سيتم إيقاف تشغيل Apiary؟
أعلنت Oracle عن إنهاء دعم Apiary في منتدياتها، وتشير التقارير الحالية من بائعي أدوات API إلى إغلاق الخدمة المستضافة حوالي سبتمبر 2026. الافتراض الآمن هو أبسط: قم بالتصدير الآن، لأن كل جزء من المنتج غير مدعوم بالفعل.
هل يمكن لـ Apidog استيراد ملفات API Blueprint مباشرة؟
لا. يستورد Apidog تنسيقات OpenAPI/Swagger، Postman، HAR، RAML، JMeter، apiDoc، I/O Docs، WADL، و Google Discovery. قم بتحويل API Blueprint إلى OpenAPI أولاً باستخدام أداة مثل api-spec-converter أو apib2swagger، ثم استورد النتيجة. إنها خطوة لمرة واحدة، وتحقق من مخططات المصادقة يدويًا بعد ذلك.
ماذا يحل محل خادم Apiary الوهمي؟
خادم Apidog الوهمي الذكي المدمج. حيث كان Apiary يعيد تشغيل الأمثلة التي كتبتها، يقوم Apidog بإنشاء استجابات واقعية من مخططاتك تلقائيًا، ويمكنك تحديد قواعد وهمية مخصصة لحالات معينة. تحصل كل نقطة نهاية مستوردة على نقطة نهاية وهمية بدون أي تهيئة.
ماذا يحل محل Dredd لاختبار العقود؟
سيناريوهات الاختبار الآلية في Apidog: ترسل طلبات حقيقية إلى تطبيقك وتتحقق من صحة الاستجابات مقابل مخططات مواصفاتك، مع تأكيدات وتنفيذ CI من خلال Apidog CLI. وهذا يغطي وظيفة Dredd بالإضافة إلى ميزات مجموعة الاختبار التي لم تكن لدى Dredd أبدًا.
هل Apidog مجاني بالفعل لفريق صغير؟
نعم. تغطي الخطة المجانية ما يصل إلى 4 مستخدمين مع محررات المواصفات، والوثائق التفاعلية المنشورة، والخادم الوهمي الذكي، واختبار API المتضمن. بعد 4 مستخدمين، تبلغ التكلفة 9 دولارات لكل مستخدم شهريًا، وهو أقل سعر لكل مقعد بين وجهات ترحيل Apiary الجادة.
صدّر اليوم، لا تعيد التصميم
ترتيب العمليات مهم: قم بالتصدير من Apiary أولاً، ثم قم بتحويل Blueprint إلى OpenAPI ثانيًا، وفقط بعد ذلك قم بتقييم الوجهات على مهل، لأن الخطوتين الأوليين لهما موعد نهائي والثالثة لا تملك. عندما تكون مستعدًا، استورد ملف OpenAPI إلى Apidog وستحصل على الوثائق، والمحاكاة، ومجموعة الاختبار قبل انتهاء فترة ما بعد الظهر. قم بتنزيل Apidog أو ابدأ في المتصفح؛ فريق مكون من 4 أشخاص لا يدفع شيئًا، وسير عمل التصميم أولاً الذي اخترعته Apiary يحصل أخيرًا على المنصة المدعومة التي يستحقها.