بناءً على أساس يناير، يضاعف فبراير التركيز على تجربة MCP والاختبار—مقدمًا رؤى تصحيح أخطاء أكثر ثراءً، وتنفيذًا متوازيًا لأطقم الاختبار، وبيانات اختبار مشتركة عبر السيناريوهات، وتقرير اختبار معاد تصميمه بالكامل، وترحيلًا سلسًا من Hoppscotch.
مرحباً بمستخدمي Apidog،
قدم يناير عميل MCP وأطقم الاختبار. أما فبراير فيتعلق بجعلها جاهزة للإنتاج.
لقد قمنا بتحسين تجربة تصحيح أخطاء MCP من خلال معاينات محتوى أكثر ثراءً—عرض Markdown، وعرض الصور، والوصول المباشر إلى حقل المحتوى. تدعم أطقم الاختبار الآن التنفيذ المتوازي لإجراء عمليات تراجع (regression runs) أسرع بكثير. نظام جديد لبيانات الاختبار المشتركة يقضي على إعداد البيانات الزائد عبر السيناريوهات. وقد تم إعادة تصميم تقرير الاختبار بالكامل من الألف إلى الياء مع عرض خطوات منظم وتصفية للفشل.
علاوة على ذلك، أطلقنا استيراد مجموعة Hoppscotch، وتحسينات في تصحيح أخطاء SSE، وقائمة طويلة من إصلاحات تحسين جودة الاستخدام عبر ثمانية إصدارات هذا الشهر.
إليكم كل جديد هذا الشهر👇
⭐ تحديثات جديدة
🔥 تجربة تصحيح أخطاء عميل MCP محسّنة
عند تصحيح أخطاء خوادم MCP باستخدام عميل MCP المدمج في Apidog، تم تحديث تجربة عرض الاستجابة بشكل شامل مع إمكانيات معاينة وتحقق من المحتوى أكثر ملاءمة.
1. عرض حقل المحتوى المباشر
عند تصحيح أخطاء خادم MCP في Apidog، يمكنك الآن عرض حقل Content الخاص بالاستجابة مباشرة في علامة التبويب "Content" —لا مزيد من البحث في JSON الخام للعثور على ما تحتاجه. لا تزال علامة التبويب "Raw" توفر حمولة JSON-RPC الكاملة للفحص العميق، مما يمنحك الأفضل من العالمين حسب سياق تصحيح الأخطاء الخاص بك.
2. معاينة عرض Markdown
عندما تحتوي استجابة MCP على محتوى Markdown، يمكنك الآن التبديل بين Markdown الخام ومعاينة معروضة. هذا يجعل من السهل التحقق بصريًا من الوثائق المنسقة، أو محتوى README، أو أي نص منظم تُرجعه أدوات MCP الخاصة بك—دون مغادرة مصحح الأخطاء.
3. معاينة الصورة
يتم الآن عرض الصور في استجابات MCP مباشرة في علامة التبويب "Preview"، مما يسمح للمطورين بالتحقق بسرعة من محتوى الصورة وتنسيقها دون الحاجة إلى أدوات خارجية. هذا مفيد بشكل خاص عند تصحيح أخطاء أدوات MCP التي تُرجع لقطات شاشة أو رسوم بيانية أو مرئيات مُولدة.
معًا، تحول هذه التحسينات الثلاثة عميل MCP من مفتش بروتوكولات خام إلى بيئة تصحيح أخطاء كاملة الدقة—حيث يمكنك رؤية ما يراه وكلاء الذكاء الاصطناعي الخاصون بك بالضبط.
🚀 أطقم الاختبار: التنفيذ المتوازي والجدولة المدركة للبيئة
بناءً على إطلاق أطقم الاختبار في يناير، نضيف قدرتين تجعلان التنسيق أكثر قوة بشكل ملحوظ.
وضع التنفيذ المتوازي
تدعم أطقم الاختبار الآن وضع التشغيل "Parallel" (متوازي)، مما يسمح بتنفيذ حالات وسيناريوهات اختبار متعددة في وقت واحد. يمكنك تكوين قواعد التنفيذ المتوازي بمرونة لتقليل الوقت الإجمالي للاختبار بشكل كبير—وهو أمر ذو قيمة خاصة لأطقم اختبار الانحدار واسعة النطاق حيث يصبح التنفيذ المتسلسل عنق الزجاجة.
مقارنة أوضاع التشغيل:
| الوضع | السلوك |
|---|---|
| متسلسل (Sequential) | تُنفذ السيناريوهات بالترتيب. تستمر المتغيرات وتنتشر عبر خطوات السيناريو—مثالي لسير العمل المعتمد. |
| متوازي (Parallel) | تُنفذ سيناريوهات متعددة في وقت واحد لتحقيق أقصى سرعة. ملاحظة: التزامن يعزل السياق بين السيناريوهات—قد تحتاج الحالات التي تعتمد على المتغيرات الأولية إلى إعادة هيكلة. |
ملاحظة: تعتمد السرعة الفعلية على موارد الجهاز المتاحة الذي يجري الاختبارات.
المهام المجدولة تدعم الآن اختيار البيئة
عند إنشاء مهام مجدولة لأطقم الاختبار، يمكنك الآن تحديد البيئة المستهدفة، مما يتيح تحكمًا دقيقًا في التنفيذ التلقائي عبر بيئات مختلفة (مثل بيئة التطوير، بيئة الإنتاج). وهذا يعني أنه يمكنك جدولة نفس المجموعة للتشغيل مقابل بيئات متعددة بترددات مختلفة—وهي قدرة حاسمة للفرق التي تدير خطوط أنابيب النشر متعددة المراحل.
🆕 بيانات الاختبار المشتركة: إمكانية إعادة الاستخدام عبر السيناريوهات
قدرة جديدة تمامًا في هذا الإصدار: بيانات الاختبار المشتركة (Shared Test Data). يمكنك الآن إنشاء مجموعات بيانات اختبار مشتركة قابلة لإعادة الاستخدام عبر سيناريوهات اختبار متعددة، مما يغير بشكل أساسي طريقة إدارة الفرق لبيانات الاختبار على نطاق واسع.
لماذا هذا مهم:
في السابق، كان كل سيناريو اختبار يحتفظ ببيانات الاختبار المعزولة الخاصة به. إذا كانت عشرة سيناريوهات تحتاج إلى نفس بيانات اعتماد المستخدم، أو تفاصيل الدفع، أو كتالوج المنتج، كان عليك تكرار تلك البيانات عشر مرات—والحفاظ عليها في عشرة أماكن.
تحل بيانات الاختبار المشتركة هذه المشكلة من خلال تقديم طبقة بيانات مركزية:
- إنشاء مرة واحدة، استخدام في كل مكان: حدد مجموعة بيانات مرة واحدة وارجع إليها من أي سيناريو اختبار في مشروعك.
- مصدر واحد للحقيقة: قم بتحديث البيانات المشتركة في مكان واحد، وستقوم كل سيناريوهات تشير إليها بالتقاط التغيير تلقائيًا.
- اختبار موحد: يضمن أن جميع السيناريوهات تختبر مقابل بيانات متسقة وصالحة—مما يزيل التناقضات الدقيقة الناتجة عن الانحراف الناتج عن النسخ واللصق.
هذا قوي بشكل خاص عند دمجه مع وضع التنفيذ المتوازي الجديد، حيث توفر البيانات المشتركة أساسًا مستقرًا لعمليات الاختبار المتزامنة.
📊 تقارير الاختبار: إعادة تصميم كاملة
تم إعادة بناء تجربة تقارير الاختبار من الألف إلى الياء هذا الشهر، وتم تقديمها عبر إصدارين (v2.8.4 و v2.8.11).
عرض الخطوات المنظم (v2.8.4)
تم إعادة تصميم واجهة مستخدم تقرير الاختبار بالكامل لدعم العرض المنظم لجميع خطوات الاختبار. بدلاً من سجل مسطح، ترى الآن عرضًا هرميًا يعكس تدفق التنفيذ الفعلي—مما يجعل من الواضح على الفور أي سيناريو وحالة وخطوة أنتجت كل نتيجة. كما تم تحسين قائمة تقارير الاختبار من خلال العرض المنظم وقدرات التصفية.
تصفية الحالات الفاشلة (v2.8.11)
بناءً على الأساس المعاد تصميمه، أضفنا فلتر للحالات الفاشلة و فحص تفصيلي على مستوى الخطوة، مما يساعدك على تحديد حالات الفشل بسرعة وفهم بالضبط ما حدث بشكل خاطئ في كل خطوة.
يتكيف التقرير بذكاء مع عرضه بناءً على سياق المشاهدة الخاص بك:
- عرض جميع الخطوات: يُعرض في هيكل شجري يوضح بوضوح التسلسل الهرمي للخطوات وسياق التنفيذ.
- تصفية الحالات الفاشلة: ينتقل تلقائيًا إلى قائمة مسطحة تجمع جميع الخطوات الفاشلة لتحديد المشكلة بسرعة.
يعني الجمع بين العرض المنظم والتصفية الذكية أنه يمكنك الانتقال من "فشلت المجموعة" إلى "هذا هو التأكيد المحدد الذي تعطل" في ثوانٍ بدلاً من دقائق.
🔗 استيراد مجموعة Hoppscotch
للفرق التي تنتقل من Hoppscotch، يدعم Apidog الآن الاستيراد المباشر لمجموعات Hoppscotch. ما عليك سوى تصدير مجموعاتك من Hoppscotch واستيرادها إلى Apidog—يتم الاحتفاظ بنقاط النهاية والمعاملات والرؤوس ونصوص الطلب الخاصة بك، مما يجعل عملية الانتقال سلسة.
ينضم هذا إلى دعم الاستيراد الحالي لدينا لـ Postman و Swagger/OpenAPI و Insomnia وتنسيقات أخرى، مما يعزز مكانة Apidog كمنصة API عالمية تلتقي بك حيثما تكون.
⚡️ تحسينات
بالإضافة إلى الميزات الرئيسية، قمنا بإطلاق سلسلة من تحسينات جودة الاستخدام:
- واجهة مستخدم الفرع المحمي (Protected Branch UI): أعيد تصميم تفاعل الفرع المحمي لتدفق عمل أنظف وأكثر سهولة.
- تجربة المستخدم لحقول التعيين المسبق الشائعة (Preset Common Fields UX): تحسين الواجهة لتطبيق الحقول المشتركة المعينة مسبقًا على نقاط النهاية، مما يقلل الاحتكاك في إعادة استخدام المخطط.
- كائن
cryptoالعام في السكربتات: تدعم سكربتات المعالجة المسبقة وبعد المعالجة الآن الكائن العامcrypto، مما يتيح عمليات التشفير (التجزئة، HMAC، التشفير) مباشرة في سكربتات الاختبار الخاصة بك دون تبعيات خارجية. - تصحيح أخطاء SSE: عند تصحيح أخطاء نقاط نهاية SSE (أحداث إرسال الخادم)، يتعامل Apidog الآن بشكل صحيح مع فواصل الأسطر
\r\n، مما يضمن تحليلًا دقيقًا لتدفق الأحداث. - سير عمل دعوة المشروع: تحسين عملية دعوة المتعاونين للانضمام إلى مشروع، مما يجعل عملية انضمام الفريق أكثر سلاسة.
- قائمة تقارير الاختبار: تدعم طريقة عرض قائمة تقارير الاختبار الآن العرض المنظم والتصفية، مما يسهل التنقل في سجلات الاختبار الكبيرة.
🐞 إصلاح الأخطاء
لقد قمنا بحل إجمالي 17 خطأً عبر ثمانية إصدارات هذا الشهر. فيما يلي أبرزها:
الاختبار والأتمتة:
- تم إصلاح مشكلة حيث كان عدد التكرارات يظهر كـ 0 في تقارير الاختبار عند استخدام
{{variable}}كعدد تكرار في الاختبارات الآلية. - تم إصلاح مشكلة حيث لا يمكن تكوين التحقق من الاستجابة عند تشغيل بيانات الاختبار دفعة واحدة من صفحة حالة الاختبار.
- تم إصلاح مشكلة حيث نقاط النهاية المخصصة للطلب لم تكن تتضمن المصادقة أحيانًا أثناء تنفيذ سيناريو الاختبار الآلي إذا لم تنتقل نقطة النهاية إلى المصادقة.
استيراد وتصدير البيانات:
- تم إصلاح مشكلة حيث لا يمكن استيراد ملفات RAML إلى Apidog.
- تم إصلاح مشكلة حيث فشلت مجموعات Hoppscotch في الاستيراد في حالات معينة.
- تم إصلاح مشكلة حيث لم يستخدم إنشاء كود SQL من مخطط اسم المخطط كاسم للجدول، مما أدى إلى أن تكون جميع أسماء الجداول
tableName.
نقطة النهاية وتصحيح الأخطاء:
- تم إصلاح مشكلة حيث لم يتم تنسيق محتوى استجابة نقاط نهاية Socket.
- تم إصلاح مشكلة حيث كان حقل إدخال معامل الرأس يفقد التركيز بعد كتابة الحرف الأول عندما كان اسم الحقل باللغة الإنجليزية.
- تم إصلاح مشكلة حيث حفظ طلب سريع مباشرة تحت مجلد فرعي كان ينقله بشكل غير صحيح إلى المجلد الجذر (v2.8.9).
- تم إصلاح مشكلة حيث لم يتم حفظ إعادة تسمية طلب سريع أحيانًا.
المنصة والحوكمة:
- تم إصلاح خطأ 500 الذي حدث في حالات معينة عند تكوين أدوار مخصصة على مستوى المؤسسة.
- تم إصلاح مشكلة حيث لم تُحرر الفروع المحذوفة ارتباطات عناوين URL المخصصة لكبار المسئولين الاقتصاديين (SEO) من نقاط النهاية.
- تم إصلاح التحقق من صحة عنوان URL في تكوين التنقل بالوثائق المنشورة.
🌟 تطلعات مستقبلية
تعكس الإصدارات الثمانية لشهر فبراير التزامنا بالإطلاق السريع والتكرار بناءً على الملاحظات. بينما ننتقل إلى مارس، نواصل تعميق تجربة تصحيح أخطاء MCP، وتوسيع قدرات تنسيق أطقم الاختبار، والاستثمار في سير العمل الأصيل للذكاء الاصطناعي الذي سيحدد الجيل القادم من تطوير API.
نعمل أيضًا بنشاط على دمج أعمق مع Git والتحرير بوضع النص للتوافق مع عادات التطوير التي تعتمد على Git أولاً—ترقبوا المزيد.
💬 انضم إلى المحادثة
تواصل مع مهندسي API الآخرين وفريق Apidog:
- انضم إلى مجتمعنا على Discord للمناقشات في الوقت الفعلي.
- شارك في مجتمعنا على Slack للتعمق التقني.
- تابعنا على X (تويتر) للحصول على آخر التحديثات.
ملاحظة: استكشف التفاصيل الكاملة لجميع هذه التحديثات في سجل تغييرات Apidog! 🚀
بناء API سعيد!
مع خالص التقدير،
فريق Apidog