هل لدى برونو خادم وهمي؟ (وما البديل المناسب؟)

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

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

لماذا تحتاج إلى خادم وهمي

يُرجع الخادم الوهمي استجابات واقعية لنقاط النهاية التي لم يتم إنشاؤها، أو غير مستقرة، أو يصعب تشغيلها عند الطلب. وهذا يفتح عدة أمور:

• التطوير المتوازي. فرق الواجهة الأمامية والجوال تبني بناءً على العقد بينما لا يزال الجزء الخلفي قيد التقدم. لا أحد ينتظر.
• اختبار مسار الخطأ. نادراً ما تقدم لك واجهات برمجة التطبيقات الحقيقية رمز 429 أو 503 عندما تحتاج إليه. الخادم الوهمي يُرجع أي حالة أو رأس أو نص مشوه عند الطلب.
• العروض التوضيحية والنماذج الأولية. اعرض سير عمل وظيفي بدون خلفية حية أو قاعدة بيانات أو بيانات اعتماد.
• التكامل المستمر المستقر (CI). الاختبارات التي تستخدم خادم وهمي لا تتعطل بسبب توقف خادم التدريج أو تحديد المعدل.

فيما يلي سيناريوهات الفشل التي يساعدك الخادم الوهمي على اختبارها عمداً، بدلاً من انتظار حدوثها في الإنتاج:

هل يمتلك برونو خادماً وهمياً؟

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

في الممارسة العملية، يغطي مستخدمو برونو الفجوة بطريقتين:

1. أدوات المحاكاة الخارجية. إعداد خدمة منفصلة مثل Mockoon أو WireMock أو Prism أو json-server، وتحديد الاستجابات هناك، ثم توجيه برونو إلى هذا العنوان URL. أداتان، ومصدران مختلفان للحقيقة.
2. الخوادم المصممة يدوياً. كتابة تطبيق صغير باستخدام Express أو Flask أو FastAPI يُرجع JSON معلباً. سريع لنقطة نهاية واحدة، وممل للصيانة عبر واجهة برمجة تطبيقات متنامية.

كلاهما يعمل. وكلاهما يضيف أجزاء متحركة تعيش خارج مجموعتك.

تكلفة المحاكاة الإضافية

ربط طبقة محاكاة منفصلة ببرونو أمر ممكن، لكن التكلفة تظهر بمرور الوقت:

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

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

أنشئ خادماً وهمياً من مواصفات OpenAPI الخاصة بك بدلاً من ذلك

المسار الأنظف هو استخلاص المحاكاة من العقد الذي تحتفظ به بالفعل. Apidog يفعل ذلك: قم باستيراد أو كتابة مواصفات OpenAPI، وسيقوم بإنشاء خادم وهمي عامل من نفس التعريفات التي تستخدمها للتصميم والاختبار والوثائق. مصدر واحد للحقيقة، وليس ثلاثة.

عدة أمور تجعل هذا مختلفاً عن الأدوات الإضافية:

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

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

كيفية سريعة: من المواصفات إلى عنوان URL للمحاكاة

إليك النسخة المختصرة من إعداد محاكاة من مواصفات موجودة:

1. استورد مواصفاتك. أحضر ملف OpenAPI (أو Swagger) الخاص بك، أو وجه Apidog إلى عنوان URL للمواصفات. تأتي نقاط النهاية والمخططات الموجودة كما هي.
2. افتح نقطة نهاية. تحتوي كل نقطة نهاية مستوردة بالفعل على مخططها، لذلك تحتوي المحاكاة على كل ما تحتاجه.
3. احصل على عنوان URL للمحاكاة. يعرض Apidog نقطة نهاية محاكاة محلية وسحابية تلقائياً. لا حاجة لنشر خادم.
4. أرسل طلباً. اضرب عنوان URL للمحاكاة وستحصل على JSON مشكّل وفقاً للمخطط، تم إنشاؤه من المواصفات.
5. ضبط الاستجابات (اختياري). أضف قواعد لرموز حالة معينة أو حالات خاصة، مثل 429، عندما تحتاج إلى اختبار مسار معين.

يمكنك توجيه الواجهة الأمامية أو بناء الجوال أو مجموعة الاختبار الخاصة بك إلى عنوان URL للمحاكاة ومواصلة العمل بينما يلحق بها الواجهة الخلفية.

متى تكون الحلول البديلة كافية

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

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

المقايضة حقيقية: المسار الخفيف يحافظ على بساطة برونو ولكنه يتركك تحافظ على المحاكاة بشكل منفصل. المسار المعتمد على المواصفات يزيل هذا الانحراف على حساب اعتماد منصة أوسع. اختر بناءً على مدى نمو واجهة برمجة التطبيقات (API) الخاصة بك.

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

هل يمتلك برونو خادم محاكاة مدمج؟

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

ما هي أسهل طريقة لإضافة المحاكاة إلى سير عمل بأسلوب برونو؟

قم بإنشاء المحاكاة من مواصفات OpenAPI الخاصة بك بدلاً من تعريفها بشكل منفصل. تقرأ أدوات مثل Apidog المواصفات وتنتج عنوان URL جاهزًا للمحاكاة، وبذلك تحتفظ بمصدر واحد للحقيقة عبر التصميم، والمحاكاة، والاختبار، والتوثيق، بدلاً من الاحتفاظ بتعريفات المحاكاة في مكان ثانٍ.

هل يمكنني الاستمرار في استخدام برونو وإضافة خادم محاكاة بجانبه؟

نعم. قم بتشغيل أداة محاكاة خارجية مثل Mockoon أو WireMock أو Prism، وقم بتعريف الاستجابات هناك، ثم وجه برونو إلى عنوان URL هذا. يعمل هذا، لكن مواصفاتك وطلباتك وبيانات المحاكاة ستعيش في أماكن منفصلة وقد تنحرف، وهذا هو السبب الرئيسي وراء توحيد الفرق لعملياتها.

إذا بدأت تكلفة الحفاظ على طبقة محاكاة منفصلة تفوق الفوائد، فمن الجدير تجربة محاكاة تعتمد على المواصفات. استورد ملف OpenAPI الخاص بك إلى Apidog وستحصل على عنوان URL وظيفي للمحاكاة في غضون دقائق، دون الحاجة لاستضافة خادم إضافي.