AsyncAPI Validator

هذه الأداة تتحقق من مستندات AsyncAPI لضمان أنها مُهيأة بشكل صحيح، صحيحة بنيوياً ومتوافقة مع مواصفات AsyncAPI v2. تستهدف مصممي واجهات API ومهندسي المنصة وفرق QA وكُتّاب التقنية الذين ينشرون أو يراجعون العقود المعتمِدة على الأحداث والقنوات والرسائل ومخططات الحمولة. بقبول YAML أو JSON، تتحقق من الأجزاء المطلوبة، السلامة البنيوية والأنماط مثل الخوادم والقنوات والرسائل والربطات. تُصدر المُحقّق تقريراً تفصيلياً يتضمن أخطاء وتحذيرات وتوجيهات للإصلاح.
يحلُّ منطق التحقق المركزي المدخلات باستخدام مفسر مخطط قوي، يحلّ المراجع ويفرض قواعد المطابقة. يجري التحقق من صحة البناء وسلامة المخطط وفحوص تقاطعية بين الحقول (مثلاً التأكد من وجود عملية واحدة على الأقل في قناة وأن مخططات الحمولة مُعرّفة). تتيح الأوضاع الاختيارية فحصاً أكثر صرامة، مثل اشتراط وجود مراجع خارجية قابلة للحل أو فرض اتفاقيات تسمية وقيود لهجة.
الاستخدامات الشائعة تتضمن التحقق من مستند AsyncAPI غير مكتمل قبل الإرسال إلى المستودع، مراجعة مواصفات حالية لضمان الاكتمال والتناسق، وإنتاج تقارير قابلة للقراءة آلياً لأنظمة CI أو أدوات التوثيق. التصميم مخصص لبيئات غير متصلة أو محدودة حيث لا يتم تشغيل حركة مرور وقت التشغيل. يركّز على جودة التصميم لا سلوك وقت التشغيل.
القيود ونطاق العمل: يفحص المُحقّق فقط بناء الجملة، الهيكل والمخططات المصرّح عنها. ليس مُحقّق وقت التشغيل ولا يمكنه ضمان سلوك API أو صحة المنطق التجاري. يعلِم عن الحقول المهجورة، والإضافات غير المدعومة، وال ambiguities المحتملة. يدعم وظائف AsyncAPI v2 القياسية والdialects الشائعة، ويظل محايداً بالنسبة إلى التوطين؛ يمكن أن تُنتَج رسائل الخطأ بلغتك المبرمجة.