عبر إصدارات Apidog من 2.8.47 إلى 2.8.50، تُسهّل تحديثات هذا الشهر أتمتة الـ API، وتكامل المستودعات، وتوثيق الـ API بشكل أكبر، بدءًا من عمليات استيراد CLI المعيارية وإنشاء حالات تصحيح الأخطاء، وصولاً إلى Bitbucket Cloud، ووصلات GitLab المستضافة ذاتيًا، والمخططات المنشورة من المواقع الفرعية للوثائق.
يهدف هذا الإصدار إلى جعل الأتمتة والتعاون عبر Git أقل تعقيدًا في الإعداد.
تركز تحديثات Apidog لشهر سبتمبر على النقاط التي غالبًا ما تُهدر فيها الفرق الوقت: إدارة هياكل المشاريع الكبيرة من السكربتات أو سير عمل الذكاء الاصطناعي، استيراد أصول الـ API إلى الوحدة الصحيحة، إنشاء أصول الاختبار دون مغادرة الطرفية، وربط مزودي Git الحاليين دون تغيير طريقة عمل الفرق.
نظرة سريعة:
- أتمتة Apidog CLI: إدارة وحدات المشروع، استيراد بيانات API متعددة التنسيقات حسب الوحدة، وإنشاء حالات اختبار تصحيح الأخطاء من ملفات التكوين.
- تكاملات مستودعات Git: إضافة اتصالات Bitbucket Cloud وGitLab On-Prem إلى سير عمل استيراد/تصدير المشروع.
- سهولة الاستخدام اليومية: معالجة أوضح لعناوين URL، تصفية أفضل لتقارير الاختبار، إكمال متغيرات بيانات الاختبار، وقائمة مشاريع أسرع.
- رؤية الوثائق والأداء: تنشر المواقع الفرعية للوثائق المخططات، وتقدم اختبارات الأداء تقارير عن أوقات الاستجابة P95 وP99.
🤖 Apidog CLI لأتمتة الـ API وسير عمل الذكاء الاصطناعي
لقد أصبح Apidog CLI بالفعل نقطة دخول مفيدة لتشغيل اختبارات CI والأتمتة. يوسع هذا الإصدار استخدامه في وقت مبكر من سير العمل: يمكن للفرق إدارة هيكل المشروع، وجلب البيانات إلى الوحدة الصحيحة، وإنشاء حالات تصحيح الأخطاء قبل تشغيل الاختبارات.
إدارة وحدات المشروع من خلال CLI
يمكن لـ Apidog CLI الآن الاستعلام عن وحدات المشروع وإنشائها وتحديثها وحذفها.
يعد هذا مفيدًا عندما يحتاج هيكل الوحدة إلى التغيير كجزء من سير عمل مؤتمت. بعد عملية الكتابة، يُعيد CLI كائن JSON منظمًا يتضمن moduleId، بحيث يمكن للسكربتات والوكلاء تمرير المعرف إلى خطوات الاستيراد أو الاختبار أو الصيانة اللاحقة بدلاً من طلب نسخه يدويًا من واجهة المستخدم.
يجعل ذلك إدارة الوحدات جزءًا من نفس الحلقة القابلة للتكرار مثل اختبار الـ API وأتمتة CI.
استيراد بيانات الـ API إلى وحدة محددة
تمت إعادة هيكلة أمر الاستيراد الخاص بـ CLI لإعادة استخدام إمكانيات تحليل عميل Apidog. يمكنك استيراد بيانات الـ API من المصادر المدعومة إلى وحدة مشروع محددة بدلاً من إنشاء البيانات أولاً في واجهة المستخدم ثم نقلها لاحقًا.
بالنسبة لعمليات الترحيل الكبيرة، تتضمن نتائج الاستيراد عدد العناصر المضافة والمُحدثة والمتجاهلة والمحذوفة. وهذا يجعل من السهل على السكربتات ووظائف CI ووكلاء الذكاء الاصطناعي التحقق مما حدث قبل الانتقال إلى الخطوة التالية.
هذا مفيد بشكل خاص عندما تحتاج تنسيقات متعددة إلى الهبوط في نفس هيكل المشروع بخطوات تنظيف يدوية أقل.
إنشاء حالات اختبار تصحيح الأخطاء من التكوين
يمكن لمستخدمي CLI الآن إنشاء حالات اختبار تصحيح أخطاء الواجهة من ملفات التكوين. يمكن للتكوين تعريف اسم الحالة، وواجهة الـ API المستهدفة، ومعلمات الطلب، وجسم الطلب، والمصادقة، والمعالجات المسبقة واللاحقة، والتحقق من صحة الاستجابة.
بعد الإنشاء، يمكن فتح حالة تصحيح الأخطاء وتحريرها وتنفيذها في Apidog مثل أي حالة تصحيح أخطاء أخرى. وهذا مفيد عندما تقوم الأتمتة أو وكيل بإعداد أصل الاختبار الأولي، ولكن المطور لا يزال يرغب في فحصه وتحسينه بصريًا.
معًا، تقلل إدارة الوحدات وعمليات الاستيراد المنظمة وإنشاء حالات تصحيح الأخطاء من العمل اليدوي عبر السكربتات المحلية وخطوط أنابيب CI/CD وسير العمل المدعوم بالذكاء الاصطناعي.
إذا كان Apidog CLI مثبتًا لديك بالفعل، فحدّثه قبل استخدام الإمكانيات الجديدة:
npm install -g apidog-cli@latestراجع وثائق Apidog CLI للحصول على أحدث مرجع للأوامر.
🔗 تكاملات مستودعات Git
يمدد شهر سبتمبر أيضًا عمليات الاستيراد/التصدير المستندة إلى Git لتشمل بيئتين شائعتين للمستودعات.
Bitbucket Cloud
تدعم عمليات استيراد وتصدير المشروع الآن مستودعات Bitbucket Cloud. يمكن للفرق التي تستخدم Bitbucket Cloud بالفعل الاحتفاظ بمستودعاتها الحالية في سير العمل بدلاً من نقل أصول الـ API إلى منصة Git أخرى.
GitLab On-Prem
يمكن للمؤسسات تهيئة مثيل GitLab On-Prem في Apidog SaaS واستخدامه في سير عمل مستودعات Git المدعومة. تدير كل مؤسسة اتصالها بشكل مستقل، بحيث يمكن للفرق الاستمرار في استخدام إعداد GitLab المستضاف ذاتيًا الحالي.
قبل الاتصال، تأكد من أن عنوان مثيل GitLab وبيئة الشبكة تفي بمتطلبات الاتصال.
⚙️ تحسينات يومية
يتناول هذا الإصدار أيضًا الملاحظات المتكررة من عمل الـ API اليومي.
عناوين URL الكاملة لم تعد تتعارض مع مسار البيئة
عند إنشاء أو تحرير واجهة API لـ HTTP، يؤدي إدخال عنوان URL كامل يبدأ بـ http:// أو https:// الآن إلى إخفاء مسار البيئة على الفور. يؤدي تغيير القيمة مرة أخرى إلى مسار نسبي إلى استعادة مسار البيئة.
يزيل هذا الارتباك الناتج عن رؤية عنوان URL كامل ومسار بيئة في نفس الوقت، ويزيل الحاجة إلى الحفظ أولاً لرؤية السلوك.
تصفية أكثر فائدة لتقارير الاختبار
تدعم قوائم تقارير الاختبار الآن التصفية حسب المشغل ومصدر التنفيذ. تمت إضافة حقول عرض ذات صلة أيضًا، مما يسهل تضييق قائمة تقارير طويلة ومقارنة السجلات الحديثة من مصادر مختلفة.
متغيرات بيانات الاختبار تظهر في الإكمال
تظهر متغيرات بيانات الاختبار الموجودة الآن في كل من إكمال التعليمات البرمجية وإكمال القيم الديناميكية. عند كتابة الطلبات أو الاختبارات، يمكنك البحث عن المتغير وتحديده مباشرة بدلاً من العودة إلى قائمة المتغيرات لنسخ اسمه.
قوائم مشاريع أسرع
قام Apidog بتحسين وقت استجابة واجهة API لقائمة المشاريع. يتم تحميل قوائم المشاريع بشكل أسرع عند الدخول إلى مساحة عمل أو تحديد موقع مشروع، مما يقلل من وقت الانتظار أثناء التنقل والتبديل المتكرر.
✨ أيضًا في هذا الإصدار
تختتم ثلاثة تغييرات هذا الشهر، وتشمل التوثيق، واختبار الأداء، وإعداد المشاريع التي تعتمد على المواصفات أولاً.
نشر المخططات من المواقع الفرعية للوثائق
يمكن للمواقع الفرعية في وثائق Apidog الآن نشر المخططات إلى جانب نقاط النهاية، بحيث يمكن لقراء الموقع المنشور رؤيتها في مكانها بدلاً من التبديل إلى الموقع الرئيسي. يمكن للمواقع الفرعية للمؤسسات تمكين هذه الإمكانية بأنفسهم.
أوقات الاستجابة P95 و P99 في اختبارات الأداء
تُبلغ نتائج اختبار الأداء الآن عن أوقات الاستجابة P95 و P99 إلى جانب المقاييس الحالية. تصف النسب المئوية الذيل البطيء الذي تخفيه المتوسطات، وهو عادة الجزء من واجهة الـ API الذي يلاحظه المستخدمون بالفعل.
إعداد مشروع وضع المواصفات واستيراد OpenAPI
تُفتح مشاريع وضع المواصفات الآن في حالة فارغة أوضح، مع ظهور نقاط الدخول لاستيراد وإنشاء OpenAPI مباشرة، بحيث يمكن لمشروع يعتمد على المواصفات أولاً أن يبدأ دون البحث عن نقطة الدخول.
🛠️ إصلاحات وتحسينات إضافية
تتضمن هذه الدورة أيضًا الإصلاحات والتغييرات الصغيرة التالية:
- تحسين طريقة عرض حالة التجربة والإجراءات في النافذة الرئيسية وشريط علامات التبويب.
- تحسين طريقة ظهور الدعوات المعلقة في قوائم أعضاء المنظمة والفريق.
- تم إصلاح مشكلة عدم توسيع متغيرات المصادقة الأساسية (Basic Auth) في كود الطلب المُولد وتم ترميزها مباشرة كـ Base64.
- تم إصلاح مشكلة عدم توسيع الحقول المرجعية لنموذج البيانات المدمج باستخدام
allOfعند تحرير علامة تبويب. - تم إصلاح مشكلة كانت فيها مراجع واجهة الـ API عبر المشاريع لنماذج البيانات غير صحيحة بعد استنساخ أو نسخ مشروع.
- تم إصلاح مشكلة كانت فيها حالات تصحيح الأخطاء التي تم إنشاؤها بواسطة CLI تعرض نوع المصادقة على أنه "لا توجد مصادقة" (No Auth) في عميل الويب ولم تطبق المصادقة.
- تم إصلاح مشكلة كانت فيها تعريفات
$refالخاصة باستجابة OpenAPI يتم تجاهلها بصمت أثناء استيراد CLI. - تم إصلاح مشكلة كانت فيها بيانات تعريف ترقيم صفحات قائمة التقرير تُرجع قيم
pageSizeوpageIndexغير صحيحة. - تم إصلاح مشكلة كانت فيها إنشاء تقارير اختبار JUnit و HTML يجعل تقرير JUnit يحتوي فقط على نتيجة حالة الاختبار الأخيرة.
- تم إصلاح مشكلة عدم إمكانية فتح القائمة المنسدلة للبيئة عند تبديل بيئات URL في اختبار API واحد.
- تمت إضافة دعم لتعطيل إدخال مكافأة الدعوة للصفحة الرئيسية عبر سياسة المؤسسة (Enterprise Policy).
للحصول على القائمة الكاملة بندًا بندًا، استكشف سجل تغييرات Apidog.
🌟 ما يعنيه هذا
يعد إصدار سبتمبر إصدارًا عمليًا للفرق التي يتزايد عملها ليشمل الأشخاص والسكربتات والوكلاء ومستودعات Git.
| التركيز | ما تم تحسينه | لماذا هو مهم |
|---|---|---|
| CLI والأتمتة | يمكن إنشاء الوحدات وعمليات الاستيراد وحالات تصحيح الأخطاء وإدارتها عبر CLI. | يمكن للأتمتة والوكلاء المشاركة مبكرًا دون إعداد يدوي لواجهة المستخدم. |
| التعاون عبر Git | يتصل Bitbucket Cloud وGitLab On-Prem بسير عمل المشروع. | يمكن للفرق الاحتفاظ بالمستودعات التي يعملون عليها بالفعل. |
| الجودة اليومية | تحسين معالجة عناوين URL وتصفية التقارير وإكمال المتغيرات وتحميل المشروع. | خطوات الإعداد والمراجعة الشائعة تتطلب اهتمامًا أقل. |
| الوثائق والاختبار والمواصفات | تُنشر المخططات مع المواقع الفرعية للوثائق، وتُبلغ نتائج الأداء عن P95 و P99، ويحصل وضع المواصفات (Spec Mode) على بداية أوضح. | المخططات، ووقت الاستجابة، والسياق الذي يعتمد على المواصفات أولاً تكون مرئية دون مغادرة سير العمل. |
💬 ابقَ على اتصال
هل لديك ملاحظات أو أسئلة؟ تواصل مع زملائك مهندسي الـ API وفريق Apidog:
- انضم إلى مجتمعنا على Discord للمناقشات والدعم في الوقت الفعلي.
- شارك في مجتمعنا على Slack للمحادثات التقنية.
- تابعنا على X (تويتر) و LinkedIn للحصول على آخر التحديثات.
ملاحظة: للحصول على كل التفاصيل في هذا الإصدار، راجع سجل تغييرات Apidog.
مع أطيب التحيات،
فريق Apidog