# Validador OpenAPI / Swagger Valida estruturalmente documentos OpenAPI 3.0/3.1 e Swagger 2.0: campos obrigatórios, integridade de caminhos/operações, códigos de resposta, resolução de $ref, unicidade de operationId e integridade de componentes > Página canônica: https://elysiatools.com/pt/tools/openapi-validator - **Categoria:** Validation - **Palavras-chave:** openapi, swagger, validar, api, spec, rest ## Visão geral O Validador OpenAPI / Swagger permite verificar a conformidade estrutural de especificações de API nos formatos OpenAPI 3.0/3.1 e Swagger 2.0, identificando erros em campos obrigatórios, referências quebradas, duplicidade de identificadores e inconsistências em componentes. ## Entradas - **Documento OpenAPI / Swagger** (textarea): openapi: 3.0.3 info: title: Example API version: 1.0.0 paths: /users: get: summary: List users responses: '200': description: OK ## Quando usar - Antes de publicar ou compartilhar a documentação de uma API REST com desenvolvedores externos. - Ao depurar erros de sintaxe ou referências $ref inválidas em arquivos YAML ou JSON de especificações OpenAPI. - Durante o processo de integração contínua para garantir que as alterações na especificação da API não quebrem o contrato. ## Como funciona - Insira ou cole o código YAML ou JSON da sua especificação OpenAPI ou Swagger no campo de entrada. - O validador analisa a estrutura do documento, verificando a presença de campos obrigatórios e a validade dos caminhos e métodos HTTP. - O sistema resolve as referências internas e externas ($ref) e verifica a unicidade dos identificadores de operação (operationId). - O resultado da validação é exibido instantaneamente, destacando erros estruturais e avisos de conformidade. ## Casos de uso - Validação rápida de contratos de API antes de gerar código cliente ou servidor. - Correção de erros de sintaxe e referências circulares ou quebradas em arquivos YAML complexos. - Auditoria de conformidade de esquemas JSON e códigos de resposta HTTP em endpoints de API. ## Perguntas frequentes ### Quais versões do OpenAPI são suportadas? O validador suporta as especificações OpenAPI 3.0, 3.1 e Swagger 2.0. ### Posso validar arquivos em formato YAML e JSON? Sim, a ferramenta aceita especificações estruturadas tanto em formato YAML quanto em JSON. ### O que acontece se houver uma referência $ref quebrada? O validador identificará a referência inválida e apontará o local exato do erro para correção. ### Por que a unicidade do operationId é importante? IDs de operação duplicados causam conflitos na geração de SDKs e na documentação interativa da API. ### Meus dados de API são salvos no servidor? Não, a validação é processada localmente e os dados da sua especificação não são armazenados. ## Ferramentas relacionadas - [Validador de Códigos Postais Globais](https://elysiatools.com/pt/tools/global-postal-code-validator): Valida formatos de códigos postais de vários países, incluindo EUA ZIP, Reino Unido, Canadá e mais - [IBAN & SWIFT Validator](https://elysiatools.com/pt/tools/iban-swift-validator): Validate International Bank Account Number (IBAN) and SWIFT/BIC codes with checksum verification - [Calculadora de soma de verificação Mod-11](https://elysiatools.com/pt/tools/mod11-checksum): Valida ou gera números com o algoritmo de dígito de controle Modulus-11 (ISO 7064) com esquemas ISBN-10 (10..2), ID norueguesa (3,7,6,1,8,9,4,5,2) e genérico 2-7. - [Validador de CEP dos EUA](https://elysiatools.com/pt/tools/us-zip-code-validator): Valida códigos postais dos Estados Unidos, incluindo formatos padrão de 5 dígitos e ZIP+4 - [Validador de Moeda](https://elysiatools.com/pt/tools/currency-validator): Valida códigos de moeda ISO 4217 - [Validador de Email](https://elysiatools.com/pt/tools/email-validator): Valida endereços de email e verifica a entregabilidade - [Validador de Arquivo .env](https://elysiatools.com/pt/tools/env-file-validator): Validar arquivos .env para erros de sintaxe e problemas comuns - [Validador Global de Números de Telefone](https://elysiatools.com/pt/tools/global-phone-validator): Valida números de telefone de vários países incluindo China, EUA e mais ## Exemplos - [Exemplos OpenAPI/Swagger](https://elysiatools.com/pt/samples/openapi): Exemplos de especificação OpenAPI/Swagger para documentação de API REST e definição de contratos - [Exemplos OpenAPI/Swagger](https://elysiatools.com/pt/samples/openapi-swagger): Exemplos abrangentes de documentação API usando OpenAPI 3.0 e especificações Swagger para serviços RESTful - [Exemplos de Processamento de Imagem Android Java](https://elysiatools.com/pt/samples/android-image-processing-java): Exemplos de processamento de imagem Android Java incluindo leitura/escrita, dimensionamento e conversão de formato - [Exemplos de Processamento de Imagem Android Kotlin](https://elysiatools.com/pt/samples/android-image-processing-kotlin): Exemplos de processamento de imagem Android Kotlin incluindo leitura/escrita, dimensionamento e conversão de formato ## Conteúdo relacionado - [Ferramentas de versionamento de API, breaking changes e revisao de release](https://elysiatools.com/pt/hubs/api-versioning-breaking-change-review): Compare versoes de API, detecte mudancas quebradoras no schema, valide compatibilidade real de respostas e revise semver e changelog em um hub focado de pre-release. - [Ferramentas de validação de identificadores, configuração e entrada](https://elysiatools.com/pt/hubs/validation-validate): Compare validadores de email, telefone, IP, datas, cron, códigos de barras, dados de pagamento e arquivos env em um único hub para entradas reais. - [Validadores de formato para identificadores, enderecos e codigos](https://elysiatools.com/pt/hubs/validation-format): Ferramentas reunidas para validacao de formato de identificadores, enderecos, contas e codigos em um unico hub. - [Ferramentas de validacao de contato, postal e envio](https://elysiatools.com/pt/hubs/contact-shipping-validation): Valide emails, telefones, codigos postais, codigos de discagem internacional e numeros de rastreio em um unico hub para fluxos de cadastro, checkout e entrega.