OpenAPI Spec Validator

Esta ferramenta valida especificações OpenAPI para garantir que estejam bem formadas e prontas para publicação. Aceita YAML ou JSON no formato OpenAPI 3.x e é destinada a designers de API, redatores técnicos, engenheiros de QA e equipes DevOps que produzem APIs e SDKs cliente. Ao verificar seções-chave como openapi, info e paths, validar tipos de dados e aplicar regras de estrutura básicas, o validador ajuda a evitar falhas em documentação, geração de clientes, testes e fluxos de integração. Não gera código nem transformações além da validação e do relatório.
Internamente, o validador analisa o documento, resolve referências $ref (locais e potencialmente remotas) e verifica restrições de compatibilidade de versão e schemas permitidos. Erros são relatados com localizações precisas, avisos sobre recursos obsoletos ou não padrão e fornece saídas quantitativas como número de endpoints, schemas, solicitações e respostas. A validação pode ser configurada para comportamento estrito ou flexível em relação a referências remotas, referências circulares e valores de exemplo ausentes, permitindo que pipelines CI imponham governança ao mesmo tempo que padrões reais de API sejam atendidos. Vantagens incluem suporte a entradas YAML e JSON, OpenAPI 3.0/3.1, saída legível por máquina e resultados compatíveis com CI/CD. Casos de uso: checagens pré-publicação, governança de API, testes de contrato e feedback inicial durante o design de API. O validador destaca operações ambíguas, problemas de esquemas de segurança e desalinhamentos entre caminhos e componentes, permitindo correções direcionadas antes da implementação.