AsyncAPI Validator

כלי זה מאמת מסמכי AsyncAPI כדי להבטיח שהם מובנים כראוי, נכונים תחבירית ותואמים ל-AsyncAPI v2. הוא מיועד למעצבי API, מהנדסי פלטפורמה, צוותי QA וכותבי טקני שמפרסמים או בודקים חוזים מונחי אירועים, ערוצי הודעות ו-schemes של payload. הוא קולט YAML או JSON ובודק סעיפים נדרשים, שלמות המבנה ותבניות כמו שרתים, ערוצים, הודעות ו-bindingים. המערכת מספקת דוח מפורט עם שגיאות, אזהרות והנחיות לתיקון.
הלוגיקה המרכזית ל-validator מנתחת את הקלט עם פרסר סכמות מוצק, פותרת הפניות ומכפידה על כללי התאמה. היא מבצעת ולידציה של תחביר, תקשורת סכמות ובדיקות בין שדות (למשל לוודא שערוץ כולל לפחות פעולה אחת ושה-schemas של payload מוגדרים). מצבים אופציונליים מאפשרים בדיקות מחמירות יותר, כגון דרישת הפניות חיצוניות שניתן לפתור או אכיפת קונבנציות שמות והגבלות דיאלקט.
מקרי שימוש נפוצים כוללים אימות מסמך AsyncAPI בטיוטה לפני הגשתו ל-repository, ביקורת של מפרט קיים לשלמות ועקביות, והפקת דוחות קריאי מכונה ל-CI או לכלי תיעוד. הכלי נועד לסביבה לא מקוונת או מוגבלת שבה אינו מתבצע תעבורת זמן-ריצה. הוא ממוקד ב איכות העיצוב על פני התנהגות בזמן-הריצה.
הגבלות והיקף: המאמת בודק רק תחביר, מבנה וש schemas שהוגדרו. אינו מאמת בזמן-הריצה ולא יכול להבטיח התנהגות API או לוגיקת עסק. הוא מסמן שדות מיושנים, הרחבות שאינן נתמכות ואי-בהירות פוטנציאליות. הוא תומך בפונקציות סטנדרטיות של AsyncAPI v2 ובדיאלקטים נפוצים ונשאר ניטרלי לגבי לוקליזציה; הודעי שגיאה יכולים להיות מיוצרים בשפה המוגדרת.