AsyncAPI Validator

Esta herramienta valida documentos AsyncAPI para asegurar que estén bien formados, sean sintácticamente correctos y cumplan con las especificaciones AsyncAPI v2. Apunta a diseñadores de API, ingenieros de plataforma, equipos de QA y redactores técnicos que publican o revisan contratos basados en eventos, canales, mensajes y esquemas de carga útil. Aceptando YAML o JSON, verifica secciones obligatorias, integridad estructural y patrones como servidores, canales, mensajes y bindings. El validador genera un informe detallado con errores, advertencias y orientación de remediación.
La lógica central de validación analiza la entrada con un parser de esquema robusto, resuelve referencias y aplica reglas de conformidad. Realiza validación de sintaxis, validación de esquemas y comprobaciones entre campos (por ejemplo, asegurar que un canal tenga al menos una operación y que se definan esquemas de payload). Modos opcionales permiten controles más estrictos, como exigir referencias externas resolubles o imponer convenciones de nombres y restricciones dialectales.
Casos de uso comunes incluyen validar un borrador de AsyncAPI antes de enviarlo al repositorio, auditar una especificación existente para completar y consistencia, y generar informes legibles por máquina para pipelines de CI o herramientas de documentación. La herramienta está diseñada para entornos fuera de línea o restringidos donde no se realiza tráfico de tiempo de ejecución. Se centra en la calidad del diseño más que en el comportamiento en tiempo de ejecución.
Limitaciones y alcance: el validador examina solo sintaxis, estructura y esquemas declarados. No es un validador en tiempo de ejecución y no puede garantizar el comportamiento de la API ni la validez de la lógica comercial. Marca campos obsoletos, extensiones no soportadas y posibles ambigüedades. Soporta funciones estándar de AsyncAPI v2 y dialectos comunes, y permanece neutral respecto a la localización; los mensajes de error pueden generarse en el idioma configurado.