Api-blueprint: هل تسمح APIARY بمضيف متعدد في نفس المشروع

أشعر بالفضول حيال هذا أيضًا. نحن نستخدم بيئات اختبار متعددة والقدرة على التبديل بينها للعثور على الاختلافات أمر بالغ الأهمية.

لا ندعم هذا حاليًا ، لكننا نعمل على إيجاد حلول تجعل ذلك ممكنًا في المستقبل.

أي تحديث على هذا؟

هل توجد أي حلول لهذه المشكلة بالفعل؟

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

Almad سأصف حالة الاستخدام الخاصة بي لتقديم بعض الملاحظات فيما يتعلق بهذه المشكلة.

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

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

ومع ذلك ، بدون خيار استخدام نطاقات فرعية متعددة ، لا يتبقى لنا سوى عدد قليل من الخيارات:

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

لا يبدو أي من الخيارات رائعة. أي توصية لقضيتنا؟

سيكون هناك حل لذلك ، لكن لسوء الحظ لا يمكنني التحدث عنه وإعطاء جداول زمنية لأن SEC والمحامين :(

هل المستقبل المنظور يعطي أملا كافيا؟

هناك أي تقدم؟

تمت إضافة دعم host للكائن في عناصر API بشكل أساسي لدعم تعيين كائن خادم OAS3. ترقبوا https://help.apiary.io/tools/interactive-documentation-v4/ تحديثات العارض.

لم أر أي تقدم للدعم في مخطط API بالرغم من ذلك.